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 密钥）

Note

对于通过 Cloudflare AI Gateway 路由的 Anthropic 模型，请使用你的 Anthropic API key 作为提供商密钥。

当为 Anthropic Messages 模型启用 thinking 时，OpenClaw 会在通过 Cloudflare AI Gateway 发送 payload 之前，移除末尾的 assistant prefill 轮次。Anthropic 拒绝在 extended thinking 中使用 response prefilling，而普通非 thinking 预填充仍然可用。

安装插件¶

安装官方插件：

openclaw plugins install @openclaw/cloudflare-ai-gateway-provider

安装会自动应用于正在运行的 Gateway；否则，它将在下次启动时生效。参见应用更改并检查。

快速开始¶

1. 设置提供商 API 密钥和 Gateway 详情

运行 onboarding 并选择 Cloudflare AI Gateway 认证选项：

openclaw onboard --auth-choice cloudflare-ai-gateway-api-key

此命令会提示输入你的 account 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 --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"

高级配置¶

已认证网关

如果你在 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