快速开始
Cloudflare AI 网关
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 密钥） |
为 Anthropic Messages 模型启用 thinking 时，OpenClaw 会在通过 Cloudflare AI Gateway 发送载荷之前移除末尾的 assistant prefill 轮次。Anthropic 会拒绝带 extended thinking 的 response prefilling，而普通的非 thinking prefill 仍然可用。
安装插件
安装官方插件，然后重启 Gateway 网关：
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restart入门指南
Set the provider API key and Gateway details
运行新手引导并选择 Cloudflare AI Gateway 凭证选项：
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key这会提示你输入 account ID、gateway ID 和 API 密钥。
Set a default model
将模型添加到你的 OpenClaw 配置：
{ agents: { defaults: { model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" }, }, },}Verify the model is available
openclaw models list --provider cloudflare-ai-gateway非交互式示例
对于脚本化或 CI 设置，请在命令行上传入所有值：
openclaw onboard --non-interactive \ --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"高级配置
Authenticated gateways
如果你在 Cloudflare 中启用了 Gateway 网关身份验证，请添加 cf-aig-authorization 标头。这是在你的提供商 API 密钥之外额外需要的。
{ models: { providers: { "cloudflare-ai-gateway": { headers: { "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>", }, }, }, },}Environment note
如果 Gateway 网关以守护进程（launchd/systemd）方式运行，请确保 CLOUDFLARE_AI_GATEWAY_API_KEY 可供该进程使用。
相关
Was this useful?
