Appearance
OpenClaw
在 OpenClaw 里用 CodexZH 套餐额度跑 GPT / Grok 模型。
1. 安装 OpenClaw
按 OpenClaw 官方文档 安装:
bash
npm install -g openclaw@latest
openclaw onboard --install-daemon2. 在控制台导入到 OpenClaw
登录 CodexZH 控制台 →「CC Switch 一键导入」,客户端选 OpenClaw,默认模型选 GPT 或 Grok 模型(如 gpt-6.1-sol),点 导入到 OpenClaw。

3. 在 CC Switch 里确认导入
浏览器询问是否打开 CC Switch 时点 打开,CC Switch 会弹出「确认导入供应商配置」:
- 核对应用类型是 OpenClaw、供应商是 CodexZH、API 端点是
https://api.codexzh.com/v1 - 确认弹窗底部的开关已打开(如「导入后立即添加到 OpenClaw 配置」,一般默认已开)
- 点 导入
没勾这个开关的:在 CC Switch 左侧选你正在配置的客户端,点 CodexZH 那一行的 ▷ 启用。下图以 Codex 为例,其他客户端操作相同。

4. 开始使用
重启网关后,在 OpenClaw 里选 CodexZH 的模型发一句话测试:
bash
openclaw gateway restartCC 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 剥离,导致缓存不命中。
- 优先配置
supportsPromptCache(上方配置已自带):在模型定义中加入"compat": { "supportsPromptCache": true }后重启 gateway。 - 旧版本或配置项未生效时给 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 退出并开新会话即可,建议每个独立任务开新会话。