通过 OpenClaw 使用 Cloudflare AI Gateway 代理 Anthropic 模型请求，只需在 onboarding 时选择 cloudflare-ai-gateway-api-key 选项，并输入你的账号 ID、Gateway ID 和 API Key。配置完成后可通过 openclaw models list --provider cloudflare-ai-gateway 验证模型可用性。如果启用了 Gateway 认证，还需额外配置 cf-aig-authorization 请求头。

OpenClaw 接入 Cloudflare AI Gateway 配置指南

Cloudflare AI Gateway 位于提供商 API 前端，让你可以添加分析、缓存和访问控制。对于 Anthropic 模型，OpenClaw 通过你的 Gateway 接口使用 Anthropic Messages API。

属性	值
Provider	`cloudflare-ai-gateway`
Base URL	`https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic`
默认模型	`cloudflare-ai-gateway/claude-sonnet-4-6`
API key	`CLOUDFLARE_AI_GATEWAY_API_KEY`（通过 Gateway 发送请求所需的提供商 API Key）

::: info 在 Cloudflare AI Gateway 中使用 Anthropic 模型时，需要提供 Anthropic API key 作为 provider key。 :::

当启用 Anthropic Messages 模型的 thinking 功能后，OpenClaw 会在通过 Cloudflare AI Gateway 发送请求前，移除助手侧的 prefilled turns。这是因为 Anthropic 拒绝在 extended thinking 模式下使用 prefilling，而在非 thinking 模式下 prefilling 不受影响。

快速开始步骤

设置 provider API key 和 Gateway 详情 运行 onboarding 命令并选择 Cloudflare AI Gateway 认证方式：
```
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
```
系统会提示你输入账号 ID、Gateway ID 和 API Key。

设置默认模型 在 OpenClaw 配置中添加默认模型：

{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}

验证模型可用性

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 请求头。此头部不替换 provider API key，而是作为 Gateway 自身的认证机制。

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

::: tip cf-aig-authorization 请求头用于和 Cloudflare Gateway 自身进行认证，而 provider API key（例如你的 Anthropic key）用于和上游提供商进行认证。两者都需要配置。 :::

环境变量注意事项

如果 Gateway 以守护进程（launchd/systemd）方式运行，请确保 CLOUDFLARE_AI_GATEWAY_API_KEY 对该守护进程可用。

::: warning 在交互式 shell 中 export 的 key 不会被 launchd/systemd 守护进程读取，除非你将环境变量导入到那个守护进程的环境。建议在 ~/.openclaw/.env 文件中设置该 key，或通过 env.shellEnv 配置，确保 Gateway 进程能够读取。 :::

常见问题

怎么确认 Cloudflare AI Gateway 配置是否生效？

执行 openclaw models list --provider cloudflare-ai-gateway 查看模型列表。如果成功列出模型，说明配置有效。

Gateway 认证 token 怎么获取？

cf-aig-authorization token 需要在 Cloudflare AI Gateway 的管理控制台中创建或获取。具体操作参考 Cloudflare 官方文档。

配置后模型调用失败怎么办？

首先检查环境变量 CLOUDFLARE_AI_GATEWAY_API_KEY 是否已正确设置，并且对运行 OpenClaw Gateway 的进程可见。其次确认账号 ID 和 Gateway ID 填写无误。如果启用了 Gateway 认证，还要确认 cf-aig-authorization 请求头是否已正确配置。

OpenClaw 接入 Cloudflare AI Gateway 配置指南 #

快速开始步骤 #

非交互式配置 #

高级配置 #

认证网关设置 #

环境变量注意事项 #

相关文档 #

常见问题 #

怎么确认 Cloudflare AI Gateway 配置是否生效？ #

Gateway 认证 token 怎么获取？ #

配置后模型调用失败怎么办？ #