摘要(首段)
一句话:OpenClaw 用户改一行 baseUrl + 一个 API Key,就能让 Claude Sonnet/Opus/Haiku 通过 CodeGateway 聚合网关接入,按 token 计费。
OpenClaw 把多家模型的协议拉平,用一份配置统一调度 Qwen / GLM / Gemini / OpenAI / Anthropic。把 Anthropic provider 的 baseUrl 改成 CodeGateway 的 Anthropic-compat 端点,Claude 系列模型就不再依赖直连 Anthropic 海外 API。
这是 OpenClaw + CodeGateway 的最小可用接入路径。Claude Code / Codex CLI / Anthropic SDK 等接入方式分别在各自专题文档里。
1. 适用场景
- 已经在用 OpenClaw 编排多个 AI agent,想加 Claude(Sonnet 4.6 / Opus 4.7 / Haiku 4.5)
- 直连 Anthropic 时遇到付款 / 网络不稳定问题,想要稳定的接入通道
- 希望在一个 Dashboard 里看 Claude 调用的 token 用量与计费
OpenClaw 是开源 AI agent 编排框架,文档见 openclaw 官方仓库。CodeGateway 是 Claude / GPT / Gemini 多模型聚合网关,详见 CodeGateway 首页。
2. 前置条件
项 | 要求 |
|---|---|
OpenClaw | 任意近期版本(本文以 |
Node.js | 18 以上(OpenClaw 自身需求) |
CodeGateway 账户 | 已注册并完成实名 / 充值;首次注册 送 $2 免费额度 |
网络 | OpenClaw 进程能访问 |
新账户的 $2 大约够 100 次中等复杂度 Claude Sonnet 调用,够把配置跑通 + 试几个真任务。
3. 获取 CodeGateway API Key
- 登录 CodeGateway Dashboard
- 进入 API 密钥 页
- 点击 创建密钥,给 key 起个名字(建议带
openclaw前缀,后续在用量页方便归因) - 复制以
sk-cg-开头的字符串。这串只出现一次,妥善保存
我们推荐为 OpenClaw 单独建 key,不要和 Claude Code / Codex CLI 等其他客户端共用同一个 key,后续在 Dashboard 看 token 用量更清楚。
4. 配置 OpenClaw
OpenClaw 的模型配置在 ~/.openclaw/openclaw.json 的 models.providers.anthropic 节点。
4.1 改 baseUrl
把 anthropic provider 的 baseUrl 指到 CodeGateway:
{
"models": {
"providers": {
"anthropic": {
"baseUrl": "https://api.codegateway.dev",
"api": "anthropic-messages",
"headers": {
"x-api-key": "${CODEGATEWAY_API_KEY}"
},
"models": [
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
{ "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
{ "id": "claude-haiku-4-5", "name": "Claude Haiku 4.5" }
]
}
}
}
}注意:OpenClaw 用 ${ENV_VAR} 占位读取环境变量,推荐把 API Key 落到 env 里,不要明文写进 json。4.2 把 API Key 写进环境变量
在 shell 配置(~/.bashrc / ~/.zshrc)里加一行:
export CODEGATEWAY_API_KEY="sk-cg-你的密钥"重启 shell 或 source ~/.zshrc 让其生效,然后重启 OpenClaw 进程让新 env 被读到。
4.3 选择主用模型
在 agents / bindings 节点里把目标 agent 的 model 字段改为 anthropic 的 model id,例如:
{
"agents": {
"code-architect": {
"model": { "provider": "anthropic", "id": "claude-sonnet-4-6" }
}
}
}模型选型的简短建议:
模型 | 何时用 | 备注 |
|---|---|---|
| 默认主力 | 性价比较高,够用 80% 编排场景 |
| 复杂架构推理 / 长上下文规划 | 单价较高,适合关键决策 |
| 高频小任务 / Worker agent | 比 Sonnet 便宜 4 倍,延迟更低 |
5. 验证连通性
我们推荐的简单验证方式 — 让 OpenClaw 跑一句问候:
openclaw run --agent code-architect --prompt "say hi in one sentence"如果配置正确,应当看到 Claude 的回复打印出来。
也可以用 curl 直接打 CodeGateway 的 Anthropic 端点确认 key 没问题:
curl -sS https://api.codegateway.dev/v1/messages \
-H "x-api-key: $CODEGATEWAY_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 64,
"messages": [{"role": "user", "content": "ping"}]
}'返回 200 + content 字段有文本就 OK。
6. 常见问题排查
6.1 401 Unauthorized / invalid_api_key
- 确认环境变量真的注入到 OpenClaw 进程(
echo $CODEGATEWAY_API_KEY能打印) - 确认 key 没写错(以
sk-cg-开头,无前后空格) - 确认在 Dashboard 里这个 key 还是 active 状态(没被禁用 / 过期)
6.2 403 Forbidden / quota 相关
6.3 模型 ID 报错
- CodeGateway 用 hyphen 风格 model id(
claude-sonnet-4-6),不要写成 Anthropic 文档里带日期的别名;hyphen 风格在 OpenClaw 里直接配更稳
6.4 网络超时 / 连接重置
- 多数网络环境下直连
api.codegateway.dev没问题。如果在企业网下被防火墙拦,联系企业 IT 把该域名加白 - 偶发 5xx 时 OpenClaw 会按你
models.fallback链回退;建议把 anthropic 配在主链、qwen / zai 配在 fallback,见 OpenClaw 文档的 fallback 章节
6.5 怎么看用量
- CodeGateway Dashboard → 用量 页:按 key / 按模型 / 按时间区间统计 token 与计费。如果第 3 步给 OpenClaw 单独建了 key,这里直接能看出 OpenClaw 这个客户端的真实用量
6.6 Q/A 速查
Q:OpenClaw 进程读不到 CODEGATEWAY_API_KEY,但 shell 里 echo $CODEGATEWAY_API_KEY 能打印,怎么回事?
A:多数情况是 OpenClaw 进程在改 env 之前就启动了,新 env 没注入旧进程。source ~/.zshrc 之后必须重启 OpenClaw 进程让它重新读 env。
Q:我同时有 Claude Code 和 OpenClaw 两个客户端,可以共用一个 CodeGateway key 吗?
A:技术上可以,我们建议分开建。Dashboard 用量页按 key 切片,共用 key 看不出哪边的 token 是哪个客户端消的,后期对账困难。
Q:CodeGateway 的 prompt cache 跟我直接用 Anthropic 有差别吗?
A:协议层完全透传,cache 命中收 cache_read 价(原 input 的 1/10),没有差别。我们在 OpenClaw + Sonnet 4.6 + 长系统提示的场景实测,启用 cache 后单次调用降本 30-60%。
7. 进阶
7.1 与既有 provider 链共存
OpenClaw 支持多 provider 并存。把 models.fallback 配成 ["anthropic", "zai", "qwen"] 这种链路,主用 Claude,Claude 出问题自动回落到 GLM / Qwen。详见 OpenClaw 文档的 fallback 配置示例。
7.2 单 agent 单模型,降低不可控
按 agent 的工作类型绑死模型,而不是让 router 自动选。架构 / 调度类 agent 用 Opus 4.7 或 Sonnet 4.6,worker / 信息抽取类 agent 用 Haiku 4.5。这样既可控,又省成本。
7.3 prompt cache 命中率
Anthropic 的 prompt cache 在 CodeGateway 网关全程透传,cache read 价格只有原始 input 的 1/10。如果你的 OpenClaw agent 有大段稳定的系统提示,启用 cache 后单调用成本能降 30–60%。设置方式见 Anthropic 官方 prompt caching 文档。
收尾
到这一步,你的 OpenClaw 已经能稳定调 Claude 系列模型,且所有调用都汇集在 CodeGateway 这一个 Dashboard 里,方便对账与观测。
下一步建议:
- 把 OpenClaw 的 default
agent.model调成 Sonnet 4.6,跑通主链路 - 设置 worker agent 用 Haiku 4.5,把成本压下来
- 在 Dashboard 设置一条 预算告警,达到日 / 月预算时邮件提醒
配置中遇到问题或想要补充的接入场景,欢迎在 反馈页 提单。