Skip to content

OpenClaw ​

在 OpenClaw 里用 CodexZH 套餐额度跑 GPT / Grok 模型。

开始前先完成 购买套餐,并装好 CC Switch。

1. 安装 OpenClaw ​

按 OpenClaw 官方文档 安装:

bash
npm install -g openclaw@latest
openclaw onboard --install-daemon

2. 在控制台导入到 OpenClaw ​

登录 CodexZH 控制台 →「CC Switch 一键导入」,客户端选 OpenClaw,默认模型选 GPT 或 Grok 模型(如 gpt-6.1-sol),点 导入到 OpenClaw。

控制台选择 OpenClaw

3. 在 CC Switch 里确认导入 ​

浏览器询问是否打开 CC Switch 时点 打开,CC Switch 会弹出「确认导入供应商配置」:

  1. 核对应用类型是 OpenClaw、供应商是 CodexZH、API 端点是 https://api.codexzh.com/v1
  2. 确认弹窗底部的开关已打开(如「导入后立即添加到 OpenClaw 配置」,一般默认已开)
  3. 点 导入

没勾这个开关的:在 CC Switch 左侧选你正在配置的客户端,点 CodexZH 那一行的 ▷ 启用。下图以 Codex 为例,其他客户端操作相同。

在 CC Switch 中启用 CodexZH

4. 开始使用 ​

重启网关后,在 OpenClaw 里选 CodexZH 的模型发一句话测试:

bash
openclaw gateway restart

CC Switch 会把 CodexZH 写进 OpenClaw 的供应商列表,导入后在 OpenClaw 里选 CodexZH 的模型即可。

没有桌面环境?手动配置

CodexZH 的模型只走 Responses API,api 必须填 openai-responses(不要填 openai 或 openai-completions)。

1. 编辑配置文件

配置文件路径:

  • macOS / Linux:~/.openclaw/openclaw.json
  • Windows:C:\Users\你的用户名\.openclaw\openclaw.json

将以下最小配置写入(或合并到)openclaw.json,把 apiKey 替换为你的真实密钥:

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "codexzh": {
        "baseUrl": "https://api.codexzh.com/v1",
        "apiKey": "sk-你的密钥",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-6.1-sol",
            "name": "gpt-6.1-sol",
            "reasoning": true,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 272000,
            "maxTokens": 8192,
            "compat": { "supportsPromptCache": true }
          },
          {
            "id": "gpt-6.1-terra",
            "name": "gpt-6.1-terra",
            "reasoning": true,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 272000,
            "maxTokens": 8192,
            "compat": { "supportsPromptCache": true }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "codexzh/gpt-6.1-sol",
        "fallbacks": ["codexzh/gpt-6.1-terra"]
      },
      "timeoutSeconds": 600,
      "contextTokens": 200000
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "123456"
    }
  }
}

可用模型名见 模型与切换。

2. 重启与常用命令

bash
openclaw gateway stop
openclaw gateway --port 18789   # 启动网关与管理界面(http://localhost:18789)
openclaw doctor --fix           # 校验并修复配置

常见问题 ​

Prompt Cache 完全不生效,缓存命中率为 0% ​

OpenClaw 2026.3.22+ 会把非官方 OpenAI 端点的 prompt_cache_key 剥离,导致缓存不命中。

  1. 优先配置 supportsPromptCache(上方配置已自带):在模型定义中加入 "compat": { "supportsPromptCache": true } 后重启 gateway。
  2. 旧版本或配置项未生效时给 dist 打补丁:
查看手动打补丁命令 / 让 OpenClaw 自动修复的提示词

手动定位并修改:

bash
grep -RIl 'function shouldStripResponsesPromptCache(model)' "$(npm root -g)/openclaw/dist"

备份文件后,在 shouldStripResponsesPromptCache(model) 的 return !isDirectOpenAIBaseUrl(model.baseUrl); 前加一行:

js
if (model.baseUrl.includes("api.codexzh.com")) return false;

保存后执行 openclaw gateway restart && openclaw health。

或把下面这段发给 OpenClaw 自动处理:

text
请在本机全局安装的 OpenClaw dist 目录(优先 /usr/lib/node_modules/openclaw/dist,其次 $(npm root -g)/openclaw/dist)中搜索 function shouldStripResponsesPromptCache(model),先备份文件,在判断前为 api.codexzh.com 返回 false 放行 prompt_cache_key,改完后重启 gateway 并运行 openclaw health 验证。只做最小修改,不要动其他逻辑。

AI 只回答问题不干活 ​

对话上下文接近上限时模型会转入保守模式。按 Ctrl + C 退出并开新会话即可,建议每个独立任务开新会话。