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

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

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

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

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

你将看到：

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

1. 模型配置入口在哪里

OpenClaw 有两个主要配置入口：

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

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

2. OpenClaw 配置大模型：先跑通再优化

在 openclaw onboard --install-daemon 中：

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

3. 核心配置文件：`~/.openclaw/openclaw.json`

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

~/.openclaw/openclaw.json

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

3.1 你只需要先理解 2 个模块

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

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

4. OpenClaw 配置国内模型（中转模型）最小模板

./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": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  },

agents.defaults.model.primary 设置为：

"dkai-openai/gpt-5.4"

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

4.1 字段解释（实用版）

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

4.2 openclaw model配置：两种方法如何对应

方法 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 改，适合在线快速调整

5. 在控制台应用配置

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

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

openclaw gateway restart
openclaw gateway status

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

6. 聊天窗口验证模型状态

6.1 查看当前模型

/model status

6.2 切换模型

/model 模型标识

例如：

/model dkai-openai/gpt-5.4

7. 回退机制（强烈建议配置）

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

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

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

推荐策略：

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

8. 常见配置错误

8.1 `baseUrl` 写错

症状：认证看似成功但请求 404/401。
处理：检查是否为正确的 OpenAI 兼容根路径（通常到 /v1）。

8.2 `primary` 与 `models` 不一致

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

8.3 只配置主模型未配置回退

症状：流量高峰时频繁任务失败。
处理：至少配置 1 个 fallback。

9. 推荐落地方案（可直接照做）

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

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

10. 常见配置速答

10.1 如何快速配置大模型？

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

10.2 默认模型怎么设置？

改 agents.defaults.model.primary 为：

"dkai-openai/gpt-5.4"

10.3 新增模型怎么做？

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

10.4 自定义模型和自定义提供商有什么区别？

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

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