Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Cloudflare AI Gateway 位于提供商 API 之前，让你能够添加分析、缓存和控制功能。对于 Anthropic，OpenClaw 会通过你的 Gateway 网关端点使用 Anthropic Messages API。
属性值
提供商cloudflare-ai-gateway
Base URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
默认模型cloudflare-ai-gateway/claude-sonnet-4-6
API keyCLOUDFLARE_AI_GATEWAY_API_KEY（你用于通过 Gateway 网关发起请求的提供商 API key）
对于通过 Cloudflare AI Gateway 路由的 Anthropic 模型，请使用你的 Anthropic API key 作为提供商密钥。
当为 Anthropic Messages 模型启用 thinking 时，OpenClaw 会在通过 Cloudflare AI Gateway 发送负载之前，去除末尾的 assistant 预填充轮次。Anthropic 会拒绝带有扩展 thinking 的响应预填充，而普通的非 thinking 预填充仍然可用。

​
入门指南

1

设置提供商 API key 和 Gateway 网关详细信息

运行新手引导并选择 Cloudflare AI Gateway 凭证选项：
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
系统会提示你输入账户 ID、Gateway 网关 ID 和 API key。
2

设置默认模型

将该模型添加到你的 OpenClaw 配置中：
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

验证该模型可用

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"

​
高级配置

如果你在 Cloudflare 中启用了 Gateway 身份验证，请添加 cf-aig-authorization 标头。这是除了你的提供商 API key 之外的额外要求。
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
cf-aig-authorization 标头用于向 Cloudflare Gateway 本身进行身份验证，而提供商 API key（例如你的 Anthropic key）用于向上游提供商进行身份验证。
如果 Gateway 网关以守护进程（launchd/systemd）方式运行，请确保 CLOUDFLARE_AI_GATEWAY_API_KEY 可供该进程使用。
如果密钥只存在于 ~/.profile 中，那么它不会对 launchd/systemd 守护进程起作用，除非该环境也被导入到那里。请在 ~/.openclaw/.env 中设置该密钥，或通过 env.shellEnv 设置，以确保 gateway 进程能够读取它。

​
相关内容

模型选择

选择提供商、模型引用和故障切换行为。

故障排除

常规故障排除和常见问题。