KKCode文档站

Appearance

OpenClaw 配置 KKCode（Claude Code + Codex） ​

OpenClaw 同时接入 KKCode 的 Claude Code 与 Codex。

1. 固定网关地址（按协议区分） ​

text
Claude / Anthropic: https://kkcode.vip/
OpenAI / Codex: https://kkcode.vip/v1

2. 前置准备 ​

  • 准备好 KKCode API Key（示例：sk-xxx）。
  • 本机已有 OpenClaw，并可执行 openclaw gateway restart。

3. 写入 ~/.openclaw/openclaw.json ​

下面模板包含两个 provider：

  • kkcode-claude：给 Claude Code 用（anthropic-messages）
  • kkcode-codex：给 Codex 用（openai-responses）
json
{
  "models": {
    "providers": {
      "kkcode-claude": {
        "baseUrl": "https://kkcode.vip/",
        "apiKey": "sk-你的KKCodeKey",
        "api": "anthropic-messages",
        "headers": {
          "User-Agent": "Mozilla/5.0"
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "api": "anthropic-messages",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      },
      "kkcode-codex": {
        "baseUrl": "https://kkcode.vip/v1",
        "apiKey": "sk-你的KKCodeKey",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.3-codex",
            "name": "GPT-5.3 Codex",
            "api": "openai-responses",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kkcode-claude/claude-sonnet-4-6"
      }
    }
  }
}

你可以把这段配置直接发给 OpenClaw，让它写入 ~/.openclaw/openclaw.json。

4. 默认模型切换（重点） ​

只需要改 agents.defaults.model.primary：

json
"primary": "kkcode-claude/claude-sonnet-4-6"

或

json
"primary": "kkcode-codex/gpt-5.3-codex"

5. 重启 OpenClaw ​

bash
openclaw gateway restart

6. 常见问题 ​

  • 401 Unauthorized：Key 填错或未生效。
  • 404 model not found：primary 指向了不存在的模型 ID。
  • 改了配置不生效：通常是没执行 openclaw gateway restart。