字节跳动旗下 AI Agent 开发平台 ——Coze（扣子）正式宣布开源，此次开源包含两大核心项目，全面覆盖 AI 智能体的开发、运维、测试与调优全流程：
- CozeStudio（扣子开发平台）CozeLoop（罗盘运维平台）
该项目采用 Apache 2.0 许可证，相关代码权益如下：
- 可商用自由：支持商业场景使用，无需附加特殊条款限制；专利保障明确：包含清晰的专利授权条款，使用时无需担忧知识产权风险；社区协作开放：鼓励全球开发者共同参与迭代，共建生态未来。
该平台以低门槛著称，仅需 2 核 CPU、4GB 内存即可运行，并配套一键部署脚本，Docker 环境即可快速启用
和 公网 Coze 开发平台相比，本地版有这些差异：
功能上少了对话流、对话智能体、多 Agent 体系，也没有AI 应用模块；
缺少自定义空间功能；
发布渠道仅支持 WEB SDK 和 API—— 不过这一取舍其实颇为合理；
授权体系目前只支持个人令牌，且有效期仅能设 30 天。
好在核心功能基本都已覆盖，诚意虽有但不算太足。但对有开发能力的用户来说，它反倒比 Dify、N8N、FastGPT 等工具更值得一试。
更何况这才只是起点，后续的迭代升级值得期待。
整个安装流程共分四步，操作起来很简单，跟着一步步来就行：
- 安装 Docker Docker 可以理解为一个 “容器软件”，里面预装了 Coze 运行所需的各种组件，是安装 Coze 的必备前提，必须先完成安装。获取 Coze 安装包 可从 GitHub 下载源码或压缩包（码蜂 AI 已整理好安装包，不会下载的同学可私信领取）。执行安装命令 进入 Coze 安装包所在的文件夹，运行对应的安装命令即可启动安装。初始化并登录 完成安装后初始化 Coze 后台，设置用户名和密码，之后就能登录使用了～
具体安装步骤，可以参考这篇文章，这里就不在过多介绍。
本篇主要介绍本地部署coze时遇到的常见问题。
Coze 本地部署常见问题与解决办法：
一、启动coze时执行docker compose --profile up -d时，出现no service selected*
把 docker-compose.yml 里面所有 profile 都删掉
或者替换一下最新的docker-compose.yml文件。
二、Error response from daemon: Ports are not available: exposing port TCP 0.0.0.0:3306 -> 0.0.0.0:0: listen tcp 0.0.0.0:3306: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.
这个问题是因为我本地MySQL服务启动着，占用了3306的端口。而coze studio开源默认MySQL对外端口是3306，所以冲突了导致。 修改（coze-studio/docker/docker-compose.yml）：
将MySQL对外暴露端口改为一个不存在的端口（比如3366）即可。其他类似端口冲突问题，按照同样方式解决。
三、[MY-012960] [InnoDB] Cannot create redo log files because data files are corrupt or the database was not shut down cleanly after creating the data files.
这个错误来自 MySQL 的 InnoDB 存储引擎，说明 MySQL 启动失败。删除已有的数据文件，重新初始化（适用于开发环境或可清除数据场景）
改进步骤：
1、清空coze-studio/docker/data目录内的文件
2、清空coze-studio/docker/volumes目录内的内容。如果你是Windows，可以直接这样删除：
四、Container coze-elasticsearch-setup service "elasticsearch-setup" didn... service "elasticsearch-setup" didn't complete successfully: exit 127
进入该容器发现找不到setup_es.sh 这个文件，实际这个文件存在的。
使用代码编辑器（如 VS Code或Notepad++）
打开 elasticsearch-setup 服务所依赖的启动脚本(coze-studio/docker/volumes/elasticsearch/setup_es.sh)。
在编辑器的右下角，你会看到 CRLF 或 LF 的标识，点击它并选择 LF。保存文件后再重新启动就解决了。
五、 如果提示"command not found" ，请检查：
◦ 安装时是否勾选了"添加到PATH"
◦ 可能需要重启电脑使PATH生效
不同系统对应不同的命令格式
六、Windows系统执行命令时报错：不是内部或外部命令，也不是可运行的程序。
这种情况是因为不同系统的命令格式不一样，可以搜索一下对应系统的命令。
比如：cp .env.example .env
则执行：copy .env.example .env
七、windows本地部署，“Error response from daemon: Ports are not available: exposing port TCP 0.0.0.0:2379 -＞ 127.0.0.1:0:2379” 如何解决？
查看占用
netstat -ano | findstr :2379
net stop winnat
net start winnat
八、Agent 对话调试 “Something error:Internal server error” 错误？
可以通过以下命令查询具体错误日志
Linux命令：docker logs coze-server | grep -i 'node execute failed'
widows命令：docker logs coze-server | findstr /i "node execute failed"
关于Coze的使用，以及工作流的搭建，我也会在之后的教程中为大家讲解， 大家可以关注我们，持续发布新的教程，欢迎进入coze交流学习群共同学习，下期见~
