加载中…
OpenClaw 用户通过 CodeGateway 聚合网关接入 Claude 模型的标准配置:改一行 baseUrl + 一个 API Key,5 分钟接通,按 token 计费。
一句话: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 等接入方式分别在各自专题文档里。
OpenClaw 是开源 AI agent 编排框架,文档见 openclaw 官方仓库。CodeGateway 是 Claude / GPT / Gemini 多模型聚合网关,详见 CodeGateway 首页。
项 | 要求 |
|---|---|
OpenClaw | 任意近期版本(本文以 |
Node.js | 18 以上(OpenClaw 自身需求) |
CodeGateway 账户 | 已注册并完成实名 / 充值;首次注册 送 $2 免费额度 |
网络 | OpenClaw 进程能访问 |
新账户的 $2 大约够 100 次中等复杂度 Claude Sonnet 调用,够把配置跑通 + 试几个真任务。
openclaw 前缀,后续在用量页方便归因)sk-cg- 开头的字符串。这串只出现一次,妥善保存我们推荐为 OpenClaw 单独建 key,不要和 Claude Code / Codex CLI 等其他客户端共用同一个 key,后续在 Dashboard 看 token 用量更清楚。
OpenClaw 的模型配置在 ~/.openclaw/openclaw.json 的 models.providers.anthropic 节点。
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。在 shell 配置(~/.bashrc / ~/.zshrc)里加一行:
export CODEGATEWAY_API_KEY="sk-cg-你的密钥"重启 shell 或 source ~/.zshrc 让其生效,然后重启 OpenClaw 进程让新 env 被读到。
在 agents / bindings 节点里把目标 agent 的 model 字段改为 anthropic 的 model id,例如:
{
"agents": {
"code-architect": {
"model": { "provider": "anthropic", "id": "claude-sonnet-4-6" }
}
}
}模型选型的简短建议:
模型 | 何时用 | 备注 |
|---|---|---|
| 默认主力 | 性价比较高,够用 80% 编排场景 |
| 复杂架构推理 / 长上下文规划 | 单价较高,适合关键决策 |
| 高频小任务 / Worker agent | 比 Sonnet 便宜 4 倍,延迟更低 |
我们推荐的简单验证方式 — 让 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。
401 Unauthorized / invalid_api_keyecho $CODEGATEWAY_API_KEY 能打印)sk-cg- 开头,无前后空格)403 Forbidden / quota 相关claude-sonnet-4-6),不要写成 Anthropic 文档里带日期的别名;hyphen 风格在 OpenClaw 里直接配更稳api.codegateway.dev 没问题。如果在企业网下被防火墙拦,联系企业 IT 把该域名加白models.fallback 链回退;建议把 anthropic 配在主链、qwen / zai 配在 fallback,见 OpenClaw 文档的 fallback 章节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%。
OpenClaw 支持多 provider 并存。把 models.fallback 配成 ["anthropic", "zai", "qwen"] 这种链路,主用 Claude,Claude 出问题自动回落到 GLM / Qwen。详见 OpenClaw 文档的 fallback 配置示例。
按 agent 的工作类型绑死模型,而不是让 router 自动选。架构 / 调度类 agent 用 Opus 4.7 或 Sonnet 4.6,worker / 信息抽取类 agent 用 Haiku 4.5。这样既可控,又省成本。
Anthropic 的 prompt cache 在 CodeGateway 网关全程透传,cache read 价格只有原始 input 的 1/10。如果你的 OpenClaw agent 有大段稳定的系统提示,启用 cache 后单调用成本能降 30–60%。设置方式见 Anthropic 官方 prompt caching 文档。
到这一步,你的 OpenClaw 已经能稳定调 Claude 系列模型,且所有调用都汇集在 CodeGateway 这一个 Dashboard 里,方便对账与观测。
下一步建议:
agent.model 调成 Sonnet 4.6,跑通主链路配置中遇到问题或想要补充的接入场景,欢迎在 反馈页 提单。