前端小王hs:清华大学出版社《后台管理实践——Vue.js+Express.js》、《Nest入门与实践》作者 网络工程师 前端工程师 项目经理 阿里云社区博客专家 email: 337674757@qq.comvx: 文章最下方有vx链接资料/交流群: vx备注openclaw抖音:小王的AI开发课🔥🔥🔥公众号:玩转龙虾实验室 OpenClaw怎么接入Deepseek?
一份快速的配置指南,涵盖从平台准备到命令行验证的全过程。
原由
默认情况下,OpenClaw的模型列表里并没有提供DeepSeek的选项,所以之前我们通常会用通义千问(Qwen)作为起点,如下图所示:

那么问题来了,如果想用上性能不错的DeepSeek模型,该怎么办呢?其实很简单,通过手动修改配置文件就能实现。接下来,咱们就一步步来看看如何给OpenClaw“添砖加瓦”。
万事开头难,接入的第一步是搞定DeepSeek开放平台那边的准备工作。主要有两件事:充值和拿钥匙(API Key)。
DeepSeek的API服务是按量计费的,调用之前必须确保账户里有足够的余额。充值入口在平台的相应位置,如下图所示:

API Key就像是连接OpenClaw和DeepSeek服务器之间的专属密码。你需要在平台上创建一个新的Key,并务必妥善保存下来,因为配置时就要用到它。创建过程参考下图:

平台那边准备就绪,接下来就该回到OpenClaw的主场了。核心操作就是编辑它的配置文件。
找到位于系统用户目录下的 .openclaw.json 文件,用文本编辑器打开。我们需要在 models 和 agents 这两个配置块里动动手脚。
假设你之前已经按教程配置好了Qwen模型,配置文件大致如下:
"models": {
"providers": {
"qwen-portal": {
"baseUrl": "https://portal.qwen.ai/v1",
"apiKey": "qwen-oauth",
"api": "openai-completions",
"models": [...]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model"
},
"models": {
"qwen-portal/coder-model": {
"alias": "qwen"
},
...
},
...
}
}
现在,我们要在 providers 对象里新增一个 deepseek 的配置项,并把它的模型也添加到 agents.defaults.models 中。同时,建议将主模型(primary)切换到DeepSeek,方便后续直接使用。修改后的核心部分如下:
"models": {
"providers": {
"qwen-portal": {...}, // 原有的Qwen配置保持不变
// 新增的deepseek配置,注意这里的apiKey要替换成你刚保存的那串字符
"deepseek": {
"baseUrl": "https://api.deepseek.com",
"apiKey": "sk-*****你创建的API keys",
"api": "openai-completions",
"models": [
{
"id": "deepseek-chat",
"name": "DeepSeek Chat",
"reasoning": false,
"input": ["text"],
...
},
{
"id": "deepseek-reasoner",
"name": "DeepSeek R1",
"reasoning": true,
"input": ["text"],
...
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "deepseek/deepseek-chat" // 切换主模型为DeepSeek
},
"models": {
"qwen-portal/coder-model": {"alias": "qwen"},
"qwen-portal/vision-model": {},
// 添加deepseek的模型别名,方便命令行调用
"deepseek/deepseek-chat": {"alias": "deepseek-chat"},
"deepseek/deepseek-reasoner": {"alias": "deepseek-r1"}
},
...
}
}
保存好配置文件后,打开终端(比如PowerShell),输入以下命令来验证配置是否生效:
openclaw models list
如果一切顺利,你会在输出的模型列表中看到刚刚添加的DeepSeek相关模型,如下图所示:

上一步虽然列出了模型,但我们还需要明确指定使用哪一个。运行以下命令,将主模型设置为DeepSeek Chat:
openclaw models set deepseek/deepseek-chat
命令执行成功后会给出确认提示,参考下图:

配置完成后,做个简单的测试是很有必要的。进行一次对话,不仅能验证连通性,还能直观地看到计费情况。下图展示了一次测试交互:

完成测试后,可以去DeepSeek平台查看消费明细。可以看到,一次简单的交互消耗极低,费用几乎可以忽略不计,如下图所示:

为了方便日后管理,这里整理了几个常用的模型管理命令,随时可以拿出来查阅:
# 查看当前已配置并启用的模型列表
openclaw models list
# 查看所有可用的模型(包括未启用的)
openclaw models list --all
# 查看当前模型的使用状态
openclaw models status
# 设置主模型(用于文本处理)
openclaw models set <provider/model>
# 设置图像模型(如需多模态功能)
openclaw models set-image <provider/model>
以上就是为OpenClaw手动接入DeepSeek模型的完整流程。操作并不复杂,关键在于配置文件的修改要细心。希望这份指南能帮你顺利完成配置,享受更高效的开发体验。
前端小王hs:清华大学出版社《后台管理实践——Vue.js+Express.js》、《Nest入门与实践》作者 网络工程师 前端工程师 项目经理 阿里云社区博客专家 email: 337674757@qq.comvx: 文章最下方有vx链接资料/交流群: vx备注openclaw抖音:小王的AI开发课公众号:玩转龙虾实验室
侠游戏发布此文仅为了传递信息,不代表侠游戏网站认同其观点或证实其描述