2026年OpenClaw 模型配置教程（国内模型／自定义模型）

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 此配置教程配合国内中转站可以快速跑通启动龙虾：https://codex.dakeai.cc/register?promo=DKAI

这篇文档解决一个核心问题：如何让 OpenClaw 稳定调用你指定的大模型，并在故障时自动回退。

高频搜索词专题入口（建议先看）：

OpenClaw 配置国内模型（中转模型）
OpenClaw 设置默认模型与添加新模型
OpenClaw 配置自定义模型提供商

关键词分工（避免内耗）：

/models/：承接泛词（模型配置总览）
/models/domestic-model/：承接国内中转模型词
/models/default-and-add-model/：承接默认模型与新增模型词
/models/custom-provider/：承接自定义模型与提供商词

你将看到：

向导里如何快速配置模型
~/.openclaw/openclaw.json 的关键结构
Raw JSON 手工配置模板
/model 指令验证与切换
fallback 回退机制**实践

OpenClaw 有两个主要配置入口：

本地文件手动配置：./openclaw/openclaw.json
Web 控制台 Config -> Raw JSON

可以在 ./openclaw/openclaw.json 中手动配置，或者在 WebUI 的 Raw JSON 中配置。
本教程主要就是针对这两种方法实现，示例会和方法一一对应。

在 openclaw onboard --install-daemon 中：

选择 QuickStart
选择模型提供商（优先 OpenAI / Anthropic）
填写 API Key
选择模型 ID（例如 gpt-5.4）

OpenClaw 的模型配置最终都落在这个文件：

~/.openclaw/openclaw.json

你可以直接用记事本打开并编辑该文件，也可以用其他编辑器。注意这是 JSON 配置，修改时不要破坏括号、逗号和引号格式。

models：模型提供商与模型清单
agents：默认模型、可选模型、回退模型策略

其余模块（meta、wizard、hooks、gateway 等）可先不动。

./openclaw/openclaw.json 中 models 字段示例（将此段整体替换原有 models 字段）。
复制替换时不要再加入其它符号，只替换下面这一段：

 "models": { "mode": "merge", "providers": { "dkai-openai": { "baseUrl": "https://codex.dakeai.cc/v1", "apiKey": "替换成你的key", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "gpt-5.4", "name": "gpt-5.4", "reasoning": true, "contextWindow": , "maxTokens": 16384 } ] } } },

agents.defaults.model.primary 设置为：

"dkai-openai/gpt-5.4"

如果你在安装教程里已经按要求完成了 API Key 和模型 ID 选择，通常只需要再把 models 段替换成上面的完整新格式，并确认 agents.defaults.model.primary 即可。

models.mode = "merge"：在默认配置上叠加你的自定义配置
providers.：一个模型提供商定义块，示例名为 dkai-openai
baseUrl：API 根地址
apiKey：访问密钥
api：协议适配类型（OpenAI 兼容接口）
agents.defaults.model.primary：默认主模型

方法 A：本地文件法（./openclaw/openclaw.json）

打开文件
替换 models 字段
检查 agents.defaults.model.primary 是否为 dkai-openai/gpt-5.4
保存并重启网关

方法 B：WebUI Raw JSON 法

打开 Config -> Raw JSON
粘贴同样的 models 配置
检查 agents.defaults.model.primary 字段
点击 Save / Update

这两种方法本质是同一份配置：

./openclaw/openclaw.json 手动改，适合 WebUI 打不开时
WebUI Raw JSON 改，适合在线快速调整

修改完成后，把 JSON 粘贴到控制台 Config -> Raw JSON，点击 Save / Update，系统会重载配置并重启相关服务。

无论你是直接改 openclaw.json，还是在 WebUI 的 Raw JSON 改配置，改完后都务必重启网关再验证：

openclaw gateway restart openclaw gateway status

如果短时间不可用，通常属于重载过程，等待几十秒后再测试。

/model status

 alt="使用 /model status 查看模型示例" loading="lazy" decoding="async" >

/model 模型标识

例如：

/model dkai-openai/gpt-5.4

 alt="使用 /model 切换模型示例" loading="lazy" decoding="async" >

OpenClaw 在长任务场景会消耗大量 Token。若只配一个模型，一旦超限、余额不足或提供商故障，任务会直接失败。

建议在 agents.defaults.model 中增加 fallbacks：

{ "agents": { "defaults": { "model": { "primary": "dkai-openai/gpt-5.4", "fallbacks": [ "dkai-openai/你的备用模型ID" ] } } } }

推荐策略：

主模型：高质量模型（复杂任务）
回退模型：dkai-openai/你的备用模型ID（建议选择同 provider 的稳定模型）

症状：/model status 看不到默认模型。
处理：统一模型标识，避免手误或大小写不一致。

先在向导完成基础模型接入（保证能对话）
再到 Raw JSON 规范化 models + agents 配置
加上 fallbacks 提升稳定性
每次改完都执行 /model status 验证

按这条路线，你可以把 OpenClaw 从“能跑”升级到“稳定可用”。

先在安装向导中完成 provider + apikey + model ID 的基础接入，再按本教程第 4 节替换 models 字段。

改 agents.defaults.model.primary 为：

"dkai-openai/gpt-5.4"

在 models.providers 下添加新的 provider 或 model，再用 /model status 验证。

自定义模型：在已有 provider 下新增模型 ID
自定义模型提供商：新增一个 provider（自定义 baseUrl、认证方式和模型集合）

下一步建议阅读：OpenClaw Channels 接入。

2026年OpenClaw 模型配置教程（国内模型／自定义模型）

相关推荐