OpenClaw 切换其他大模型(以DeepSeek为例)
-
- [一、启动 openclaw 初始化向导](#一、启动 openclaw 初始化向导)
- 二、修改核心配置
前言:
- 和大部分模型切换一样,只需要从官网找大模型的
base_url,密钥,大模型ID, 然后配置在openclaw即可。
一、启动 openclaw 初始化向导
文章以切换 deepseek 大模型为例
在终端执行以下指令:
bash
openclaw onboard
后续步骤跟初始化 Qwen(千问) 大模型差不多,有几个需要注意的点。
第一、二步,依次选择, Yes , QuickStart 。
第三步,选择:第二个( Update values )
◆ Config handling
│ ● Use existing values
│ ○ Update values
│ ○ Reset
└
| 选项 | 含义 | 适用场景 |
|---|---|---|
Use existing values (使用现有值) |
保留当前 ~/.openclaw/openclaw.json 配置文件中的所有内容,初始化向导不会修改任何已配置的信息(如 API Key、模型、提供商等),仅引导你完成未配置的必填项(如果有)。 |
❌ 你需要修改当前模型的一些配置 |
Update values (更新值) |
初始化向导会读取现有配置,允许你修改 / 补充已有配置(比如更新 DeepSeek API Key、调整默认模型、新增提供商等),修改后会覆盖原有配置的对应字段。 | ✅ 你需要切换其它模型(推荐) |
Reset (重置) |
清空所有现有配置(删除 openclaw.json),初始化向导会从头开始引导你配置,相当于「全新安装」。 |
❌ 仅当配置文件损坏 / 想彻底重新配置时选 |
二、修改核心配置
接下来是选择模型提供商,往下找,找到: Custom Provider (Any OpenAI or Anthropic compatible endpoint) , 并选择。
接下来你需要填写核心配置项,这里给出 DeepSeek-API 官方文档

| 配置项 | 填写内容 | 说明 |
|---|---|---|
| API Base URL | https://api.deepseek.com/v1 |
DeepSeek 官方提供的 API 接口地址 |
| How do you want to provide this API key? | Paste API key now | 你想通过什么方式提供API-key ✅ 第一个表示现在就提供api-key 生产环境推荐 Use secret reference 环境变量引用 |
| API Key | sk-xxx( 填写你自己的 api-key ) | 格式为: sk-xxx 将你申请的api-key, 粘贴到此处 |
| Endpoint compatibility | OpenAI-compatible | 端点兼容性,选择与 OpenAI 兼容的这个接口 |
| Model ID | deepseek-chat |
模型ID, DeepSeek 官方通用对话模型,需与接口返回的有效模型ID完全一致 |
| Endpoint ID | custom-api-deepseek-com(保持默认) |
保持默认值即可 |
| Model alias (optional) | 设置模型别名。这是个可选参数,不填。 |
接下来就跟初始化 Qwen(千问) 大模型一致了:
消息通道(Select channel (QuickStart)) 选择跳过,Skip for now
搜索服务提供商(Search provider) 选择跳过,Skip for now
配置技能(Configure skills now? (recommended)) 选择跳过,No
启用钩子?(Enable hooks?) 选择跳过,Skip for now
重启已安装的 Gateway 服务,选择 Restart , 等同于 openclaw gateway restart 配置完成后可以直接在浏览器打开。
| 选项 | 核心含义 | 选择 |
|---|---|---|
| Restart | 重启已安装的 Gateway 服务(保留现有配置,仅重新加载) | ✅ 推荐(让新的 deepseek 模型配置生效,重启即可) |
| Reinstall | 重新安装 Gateway 服务(会覆盖配置 / 重新编译,无必要) | ❌ 仅服务损坏时需要,切换模型无需重装 |
| Skip | 跳过服务操作(配置不会生效,模型切换失败) | ❌ 绝对不选(修改的 deepseek 配置不会被加载) |

End
你好,少年,未来可期~