====== OpenClaw 接入 duojie.games 模型配置教程 ======

本教程教你如何在已安装的 OpenClaw 中，配置并切换到 duojie.games 的模型（默认使用 claude-sonnet-4-6）。

===== 方法一：npx 一键配置（推荐小白）=====

不想手动改配置文件？一条命令搞定：

<code bash>
npx duojie-helper@latest
</code>

运行后会有交互式向导：
  - 输入你的 duojie.games API Key
  - 勾选 **OpenClaw**
  - 自动写入配置，完成！

<note tip>建议用 ''@latest'' 确保使用最新版本。</note>

----

===== 方法二：手动配置 =====

如果你想自己控制配置细节，按下面步骤操作。

===== 准备工作 =====

你需要一个 duojie.games 的 API Key。

<note important>
**兑换码 ≠ API Key**

闲鱼买的兑换码是用来充值余额的，不是 API Key。
充值完成后，需要在 [[https://api.duojie.games|令牌页面]] 单独创建 API Key。
</note>

===== 第一步：找到配置文件 =====

配置文件路径：

^ 系统 ^ 路径 ^
| Windows | ''C:\Users\<用户名>\.openclaw\openclaw.json'' |
| macOS / Linux | ''~/.openclaw/openclaw.json'' |

**快速打开：**
<code bash>
# macOS / Linux
open ~/.openclaw

# Windows（资源管理器地址栏输入）
%USERPROFILE%\.openclaw
</code>

<note>如果 ''openclaw.json'' 不存在，手动创建即可。</note>

===== 第二步：填入配置 =====

用文本编辑器打开 ''openclaw.json''，加入以下内容：

<code json>
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "duojie/claude-sonnet-4-6"
      },
      "models": {
        "duojie/claude-sonnet-4-6":      { "alias": "Sonnet 4.6 [duojie]" },
        "duojie/claude-sonnet-4-5":      { "alias": "Sonnet 4.5 [duojie]" },
        "duojie/claude-opus-4-6-kiro":   { "alias": "Opus 4.6 Kiro [duojie]" },
        "duojie/claude-opus-4-5-kiro":   { "alias": "Opus 4.5 Kiro [duojie]" },
        "duojie/claude-haiku-4-5":       { "alias": "Haiku 4.5 [duojie]" }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "duojie": {
        "baseUrl": "https://api.duojie.games/v1",
        "apiKey": "你的duojie.games API Key",
        "api": "openai-completions",
        "models": [
          { "id": "claude-sonnet-4-6",    "name": "Claude Sonnet 4.6" },
          { "id": "claude-sonnet-4-5",    "name": "Claude Sonnet 4.5" },
          { "id": "claude-opus-4-6-kiro", "name": "Claude Opus 4.6 Kiro" },
          { "id": "claude-opus-4-5-kiro", "name": "Claude Opus 4.5 Kiro" },
          { "id": "claude-haiku-4-5",     "name": "Claude Haiku 4.5" },
          { "id": "glm-5",               "name": "GLM-5" }
        ]
      }
    }
  }
}
</code>

把 ''你的duojie.games API Key'' 替换成你在令牌页面生成的 Key。

**配置说明：**

^ 字段 ^ 说明 ^
| ''model.primary'' | 默认使用的模型，格式为 ''provider名/模型id'' |
| ''models''（agents 下） | 可选模型列表，决定 ''/model'' 命令里显示哪些 |
| ''alias'' | 模型在界面上显示的名称，可以随便改 |
| ''models.providers.duojie'' | 自定义 provider，告诉 OpenClaw 去哪里请求、用什么 Key |
| ''baseUrl'' | duojie.games 的 API 地址 |
| ''api'' | 接口协议，duojie.games 兼容 OpenAI 格式，填 ''openai-completions'' |

===== 第三步：切换模型 =====

配置保存后 OpenClaw 会自动热重载，无需重启。

在聊天界面发送：
<code>
/model
</code>

从弹出的列表里选择你配置的模型即可。

===== duojie.games 可用模型 =====

在 ''models'' 里可以按需添加以下模型：

^ 模型 id ^ 说明 ^
| ''claude-sonnet-4-6'' | 推荐，性价比高 |
| ''claude-sonnet-4-5'' | Sonnet 上一代 |
| ''claude-opus-4-6-kiro'' | 最强，来自 Kiro |
| ''claude-opus-4-5-kiro'' | Opus 上一代，来自 Kiro |
| ''claude-haiku-4-5'' | 最快最便宜 |
| ''glm-5'' | 智谱 GLM-5 |

===== 验证配置 =====

如果配置后模型不出现，运行：
<code bash>
openclaw doctor
</code>

会告诉你配置文件哪里有问题。

===== 常见问题 =====

**Q: 提示 401 错误？**

A: API Key 填错了。去 [[https://api.duojie.games|令牌页面]] 重新生成一个，注意不要把兑换码当 Key 用。

----

**Q: /model 列表里看不到配置的模型？**

A: ''openclaw.json'' 格式有误。用 [[https://jsonlint.com/|在线 JSON 校验工具]] 检查一下语法，然后重启 OpenClaw。

----

**Q: 提示 400 错误？**

A: 模型 id 写错了，检查 ''models.providers.duojie.models'' 里的 ''id'' 是否和上面表格一致。