
手把手教你在 OpenClaw 最新版集成 DeepSeek 模型(DeepSeek-V3 / R1 / Coder 全覆盖)
2026 年初,OpenClaw(前身 Clawdbot / Moltbot)凭借 200k+ GitHub star,成为自建 AI 助手阵营中最火的开源项目之一。它支持 Telegram、Web 聊天、自定义 Agent、技能节点,还能轻松接入各种大模型。
今天这篇教程带你把 国内最强性价比模型之一 —— DeepSeek 完整集成到 OpenClaw 里,包括:
云端 API 方式(最推荐新手,速度快、成本低)
本地 Ollama / LM Studio 方式(完全私有化、零成本)
我们会覆盖目前主流的 DeepSeek 系列模型:
deepseek-chat / deepseek-reasoner(R1 系列,推理极强)
deepseek-coder(编程领域天花板级)
DeepSeek-V3 / V3.1(开源满血版,需要较高显存)
两种方式任选其一,跟着做基本都能跑通。
前置条件
在开始之前,请确保你已经:
1.安装最新版 OpenClaw gateway(见其他文章,或联系本人)
2.gateway 正常运行,dashboard 能打开(默认 http://localhost:端口)
3.Node.js 版本 ≥ 20(推荐 20 LTS 或 22.x)
4.有稳定的网络(如果用官方 API,国内建议全程代理)
方式一:使用 DeepSeek 官方API(最简单、速度最快、强烈推荐)
DeepSeek 官方 API 完全兼容OpenAI 格式,调用成本极低(尤其是 R1 推理模型,千token 几分钱)。
步骤 1:注册并获取 API Key
打开官网:https://platform.deepseek.com/ 注册 / 登录 左侧菜单 → API Keys → 创建新密钥 复制 sk- 开头的 Key(注意不要泄露)
步骤 2:配置到OpenClaw
推荐方式:在用户目录下创建或编辑配置文件:
# Windows: C:\Users\你的用户名\.openclaw\openclaw.json
# macOS/Linux: ~/.openclaw/openclaw.json
编辑openclaw.json文件,用记事本或其他文本编辑器。不建议用word
写入以下内容(替换你的 Key):
{
"env": {
"DEEPSEEK_API_KEY": "sk-你的DeepSeek-API-Key"
},
"models": {
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"api": "openai-completions"
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "deepseek/deepseek-reasoner",
"fallbacks": [
"deepseek/deepseek-chat",
"deepseek/deepseek-coder"
]
}
}
}
}
或者使用环境变量方式(适合临时测试):
# windows PowerShell
$env:DEEPSEEK_API_KEY = "sk-你的Key"
# Linux/macOS
export DEEPSEEK_API_KEY=sk-你的Key
步骤 3:重启 gateway 并验证
openclaw gateway
然后打开控制面板
openclaw dashboard

打开 dashboard → Chat → 新建会话 直接输入:“用中文介绍一下你自己” 想切换模型?在聊天框输入:
/model deepseek/deepseek-coder
然后问一个问题,比如:“用Java语言开发一个Hello world
成功标志:模型正常回复,日志中没有 fetch failed、401 unauthorized 等错误。”
夜雨聆风