跳转到内容
OpenClaw API 文档

常见问题

下面是 OpenClaw API 最常被问到的 12 个问题。本页同时注入了 FAQPage 结构化数据（schema.org），AI 引擎（ChatGPT / Claude / Perplexity / Gemini）能直接 parse 出 Q&A 列表用于引用。

OpenClaw API 是什么？

Section titled “OpenClaw API 是什么？”

OpenClaw API 是面向中国开发者的 LLM API 网关，把 50+ 主流 AI 模型（ChatGPT、Claude、Gemini、Codex 等）通过统一的 OpenAI / Anthropic 兼容接口对外暴露，国内可直连，支持人民币付款。详见 关于 OpenClaw API。

OpenClaw API 多少钱？跟官方比便宜多少？

Section titled “OpenClaw API 多少钱？跟官方比便宜多少？”

OpenClaw 价格是模型官方价的 1-3 折（10%-30%），按 token 计费，不绑定套餐。具体单价见 模型广场。

OpenClaw API 国内能直接用吗？需要科学上网吗？

Section titled “OpenClaw API 国内能直接用吗？需要科学上网吗？”

能。base URL https://cn.openclaw-api.com 经 CDN 加速直连国内，不需要科学上网。海外用户用 https://openclaw-api.com 主域同样可访问。

怎么注册和充值？

Section titled “怎么注册和充值？”
  1. 邮箱注册 https://openclaw-api.com/register
  2. 到 https://openclaw-api.com/console/topup 用支付宝 / 微信扫码充值，或在「兑换码」处兑换
  3. 在 https://openclaw-api.com/console/token 创建 API Key

完整 4 步走见 快速接入。

支持哪些 AI 模型？

Section titled “支持哪些 AI 模型？”

支持 50+ 主流模型，包括：

  • Claude：Opus 4.7 / Opus 4.6 / Sonnet 4.6
  • GPT：GPT 5.5 / GPT 5.4
  • Codex：Codex 5.3
  • Gemini 系列
  • 其他主流开源模型

完整列表 + 实时定价见 模型广场。

支持哪些 API 协议？OpenAI 兼容还是 Anthropic 兼容？

Section titled “支持哪些 API 协议？OpenAI 兼容还是 Anthropic 兼容？”

两个都支持：

  • OpenAI Chat Completions 协议：base URL https://cn.openclaw-api.com/v1
  • Anthropic Messages 协议：base URL https://cn.openclaw-api.com

流式 streaming、工具调用（function calling）、vision（图像理解）都支持。

怎么把 Claude Code / Codex / CC-Switch / TRAE / WorkBuddy 等工具接到 OpenClaw？

Section titled “怎么把 Claude Code / Codex / CC-Switch / TRAE / WorkBuddy 等工具接到 OpenClaw？”

改 base URL 即可。各客户端的具体配置步骤：

余额会过期吗？能退款吗？

Section titled “余额会过期吗？能退款吗？”

充值的余额永不过期，未使用部分会一直保留在账户。

OpenClaw 不支持退款，请按需充值。

调用失败或报错怎么排查？

Section titled “调用失败或报错怎么排查？”

常见排查步骤：

  1. 检查 base URL 末尾是 /v1（OpenAI 协议）还是直接根路径（Anthropic 协议）
  2. 检查 API Key 是 sk- 开头且没误带空格
  3. 在 OpenClaw 后台令牌管理看 Key 是否仍启用
  4. 检查账户余额
  5. 排查本地网络

Codex 用户额外注意 wire_api = "responses"（不是 "chat"），详见 Codex 接入。

我的 API 请求会被记录吗？数据隐私如何？

Section titled “我的 API 请求会被记录吗？数据隐私如何？”

OpenClaw 不主动保存请求 body 和响应 body，仅在异常排查（如调用失败的诊断）时会临时记录最小必要信息。

如有严格隐私合规要求（金融、医疗、政企等），建议直接走模型方官方 API。详见 关于 OpenClaw API 的”不一定适合谁用”。

流式 streaming / 工具调用 / vision（图像理解）支持吗？

Section titled “流式 streaming / 工具调用 / vision（图像理解）支持吗？”

三个都支持：

  • 流式 streaming — 走标准 OpenAI SSE / Anthropic streaming 协议
  • 工具调用（function calling、tool use）— 跟官方 API 行为一致
  • vision — 支持 GPT-4o / Claude 等模型方提供的图像输入能力

OpenClaw 跟其他中转服务 / 官方 API / 自部署 new-api 的区别？

Section titled “OpenClaw 跟其他中转服务 / 官方 API / 自部署 new-api 的区别？”

OpenClaw 是商业化运营的 reseller 网关，特点是国内人民币付款、多节点调度、99.99% 在线率。简单对比：

  • vs 野路子中转：定价透明 + 公开计费 + 实体发票
  • vs 官方 API：便宜 70-90%，但发票是 OpenClaw 实体的
  • vs 自部署 new-api：免运维 + 商业 SLA + 国内 CDN 加速

完整事实表见 对比方案。