Agent 绑定 DeepSeek 模型操作手册

隔离agent工作目录丨指定新增 / 删除模型均按此流程操作

今天分享一份为 Agent 绑定 DeepSeek 模型的完整操作手册，可直接复用，以后新增或删除模型都按这个流程来。

一、准备工作

DeepSeek 信息

• 模型标识：deepseek/deepseek-chat（格式：服务商/模型ID）
• API 地址：https://api.deepseek.com/v1
• API Key：sk-7588…06181（请替换为你自己的 Key）

Agent 信息

• Agent ID：sx12-deepseek
• 工作目录：C:\Users\c\.openclaw\workspace\sx12-deepseek
• 配置目录：C:\Users\c\.openclaw\agents\sx12-deepseek\

二、步骤 1：主配置文件 openclaw.json 修改

文件路径：C:\Users\c\.openclaw\openclaw.json

1.1 在 models.providers 下添加 DeepSeek 配置

在 models.providers 节点（与 qwen 同级），添加 DeepSeek 服务商定义：

"deepseek": 

{  "baseUrl": "https://api.deepseek.com/v1",  "api": "openai-completions",  "models": [     {      "id": "deepseek-chat",      "name": "deepseek-chat",      "reasoning": false,      "input": ["text"],      "contextWindow": 128000,      "maxTokens": 8192     }   ] }

1.2 在 agents.defaults.models 中注册模型

在 agents.defaults.models 节点，添加 DeepSeek 模型别名：

"deepseek/deepseek-chat": {}

1.3 在 agents.list 中给 Agent 指定模型

找到 sx12-deepseek 对应的条目，添加 model 字段：

{  "id": "sx12-deepseek",  "name": "sx12-deepseek",  "workspace": "C:\\Users\\c\\.openclaw\\workspace\\sx12-deepseek",  "agentDir": "C:\\Users\\c\\.openclaw\\agents\\sx12-deepseek\\agent",  "model": "deepseek/deepseek-chat"}

💡 注意：如果 Agent 已经在 UI 里绑定了模型，这一步可省略，但建议保持配置文件与 UI 一致。

三、步骤 2：Agent 独立配置文件 config.json 修改

文件路径：C:\Users\c\.openclaw\agents\sx12-deepseek\config.json

3.1 写入 Agent 专属配置（覆盖原有内容）

{  "model": {    "primary": "deepseek/deepseek-chat"   },  "env": {    "DEEPSEEK_API_KEY": "sk-7588...06181"   } }

• model.primary：强制该 Agent 使用 DeepSeek 模型，覆盖全局默认。
• env.DEEPSEEK_API_KEY：将密钥写入 Agent 独立环境变量，避免主配置泄露密钥，同时兼容 OpenClaw 认证规则。

四、步骤 3：重启网关并验证

4.1 重启网关

# 先停止旧进程（可选，端口被占用时用）openclaw gateway stop taskkill /F /IM openclaw.exe /T# 重启网关openclaw gateway restart

4.2 验证配置是否生效

• 查看网关日志，运行 openclaw gateway，看到 [gateway] ready 即代表启动成功。
• 进入 OpenClaw UI，找到 sx12-deepseek Agent 的模型下拉框，确认 deepseek/deepseek-chat 已存在并被选中。
• 在绑定了该 Agent 的飞书群里发送测试消息，验证模型响应正常。

五、删除 / 解绑模型的反向步骤

场景 1：解绑单个 Agent 的 DeepSeek 模型

1. 删除 config.json 中的 model 和 env 字段，恢复为空对象 {}。
2. （可选）在 openclaw.json 的 agents.list 中删除该 Agent 的 model 字段。
3. 重启网关，该 Agent 将自动使用全局默认模型。

场景 2：完全删除 DeepSeek 服务商配置

1. 从 openclaw.json 中删除 models.providers 下的 deepseek 节点。
2. 从 agents.defaults.models 中删除 deepseek/deepseek-chat 条目。
3. 重启网关，所有绑定该模型的 Agent 会自动失效，需重新配置。

六、关键避坑点

⛔ 主配置中不要写 apiKey：models.providers.deepseek 里写 apiKey 会导致网关启动失败，密钥必须放在 Agent 独立 config.json 的 env 中。

✅ 模型标识必须一致：Agent 中写的 deepseek/deepseek-chat，必须和 models.providers.deepseek.models[].id 完全匹配。

🔄 修改后必须重启网关：配置修改不会实时生效，必须执行 openclaw gateway restart。

🔌 端口占用处理：重启失败时，用 taskkill /F /PID <占用端口的进程号> 强制结束旧进程。

写在最后

这份手册覆盖了从零绑定到完全删除的完整流程，建议收藏备用。如果你在配置过程中遇到问题，欢迎在评论区留言交流。