Cloudflare AI gateway
Cloudflare AI Gateway 位于提供商 API 之前,并添加分析、缓存和控制功能。对于 Anthropic,OpenClaw 会通过你的 Gateway 端点使用 Anthropic Messages API。
| 属性 | 值 |
|---|---|
| 提供商 | cloudflare-ai-gateway |
| 插件 | 官方外部软件包(@openclaw/cloudflare-ai-gateway-provider) |
| 基础 URL | https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic |
| 默认模型 | cloudflare-ai-gateway/claude-sonnet-4-6 |
| API 密钥 | CLOUDFLARE_AI_GATEWAY_API_KEY(用于通过 Gateway 发起请求的提供商 API 密钥) |
Note
对于通过 Cloudflare AI Gateway 路由的 Anthropic 模型,请使用你的 Anthropic API 密钥 作为提供商密钥。
当为 Anthropic Messages 模型启用 thinking 时,OpenClaw 会在通过 Cloudflare AI Gateway 发送负载之前,移除末尾的 assistant prefill 轮次。Anthropic 会拒绝在 extended thinking 下使用 response prefilling,而普通的非 thinking prefill 仍然可用。
安装插件¶
安装官方插件:
安装会自动应用于正在运行的 Gateway;否则将在下次启动时生效。参见 应用更改并检查。
快速开始¶
1. 设置提供商 API 密钥和 Gateway 详细信息
运行引导流程并选择 Cloudflare AI Gateway 身份验证选项:
此操作会提示你输入账户 ID、Gateway ID 和 API 密钥。
2. 设置默认模型
将该模型添加到你的 OpenClaw 配置中:
3. 验证模型可用
非交互式示例¶
对于脚本或 CI 环境,请在命令行中传入所有值:
openclaw onboard --non-interactive --accept-risk --skip-health \
--mode local \
--auth-choice cloudflare-ai-gateway-api-key \
--cloudflare-ai-gateway-account-id "your-account-id" \
--cloudflare-ai-gateway-gateway-id "your-gateway-id" \
--cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY"
高级配置¶
已身份验证的 Gateway
如果你在 Cloudflare 中启用了 Gateway 身份验证,请添加 `cf-aig-authorization` 请求头。此请求头是在你的提供商 API 密钥之外额外添加的。
```json5
{
models: {
providers: {
"cloudflare-ai-gateway": {
headers: {
"cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
},
},
},
},
}
```
Tip
cf-aig-authorization 请求头用于向 Cloudflare Gateway 本身进行身份验证,而提供商 API 密钥(例如你的 Anthropic 密钥)用于向上游提供商进行身份验证。
环境说明
如果 Gateway 作为守护进程(launchd/systemd)运行,请确保 `CLOUDFLARE_AI_GATEWAY_API_KEY` 对该进程可用。
Warning
仅在交互式 shell 中导出的密钥,除非该环境也被导入到守护进程中,否则对 launchd/systemd 守护进程没有帮助。请将密钥设置在 ~/.openclaw/.env 中,或通过 env.shellEnv 设置,以确保 Gateway 进程可以读取它。
相关¶
选择提供商、模型引用和故障转移行为。
通用故障排除和常见问题解答。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw