Coze智能体本地部署操作步骤
一、前置准备（Windows专用）
1.开启WSL（必须）
1.1以管理员身份打开PowerShell
输入命令：wsl --install
2.安装Docker Desktop
下载地址：https://www.docker.com/get-started/
安装后打开Docker Desktop，先配置镜像加速：
2.1点击右上角Settings（设置）
2.2找到Docker Engine
2.3清空原有内容，粘贴你指定的镜像配置：
{ "registry-mirrors": [
"https://hub.geekery.cn",
"https://hub.littlediary.cn",
"https://docker.rainbond.cc",
"https://docker.unsee.tech",
"https://docker.m.daocloud.io",
"https://hub.crdz.gq",
"https://docker.nastool.de",
"https://hub.firefly.store",
"https://registry.dockermirror.com",
"https://docker.1panelproxy.com",
"https://hub.rat.dev",
"https://docker.udayun.com",
"https://docker.kejilion.pro",
"https://dhub.kubesre.xyz",
"https://docker.1panel.live",
"https://dockerpull.org"
]
}
2.4点击Apply & Restart等待重启完成
3. 安装 Git
下载地址：https://git-scm.com/download/win一路默认安装即可，自动配置环境变量，无需手动设置
验证安装（打开普通cmd / PowerShell 均可）：
docker --version
docker compose version
git --version
二、部署Coze Studio（扣子智能体）
1.拉取源码
打开任意文件夹，在地址栏输入cmd打开命令行，执行：
git clonehttps://github.com/coze-dev/coze-studio.git
2.进入配置目录
cd coze-studio
cd docker
3.生成环境配置文件
copy .env.example .env
4.启动Docker 容器
docker compose up -d #等待会，自动下载并启动所有服务。
5.访问Coze 平台
浏览器打开：http://localhost:8888注册账号即可进入后台
三、部署本地大模型（Ollama）
1.下载地址：https://ollama.com/ #安装完成后，无需手动启动，自动后台运行。
ollama --version
2.拉取本地模型
ollama pull qwen2:7b #约4G
四、让Coze 连接本地 Ollama 模型
1.进入模型配置文件夹
在cmd中输：cd ../backend/conf/model
2.复制Ollama 配置模板
copy template/model_template_ollama.yaml ollama.yaml
3.修改配置文件
用记事本打开ollama.yaml，全部替换为以下内容：
model_name: "ollama-qwen2"
model_type:"llm"
provider: "openai"
base_url: "http://host.docker.internal:11434/v1"
api_key: "dummy"
model: "qwen2:7b"
最后保存并关闭。
五、重启Coze 使配置生效
回到docker 目录：
cd ../../../docker #自己保存docker文件的路径
停止容器：
docker compose down
重新启动：
docker compose up -d
六、使用本地AI模型
1.打开http://localhost:8888
2.新建智能体
3.开始对话=完全本地运行，无需联网，不走云端
文件安装的网址
docker： https://www.docker.com/get-started/
git: https://git-scm.com/install/windows
GitHub: https://github.com/coze-dev/coze-studio#
