通过 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 认证方式：
bash
```
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
```
系统会提示你输入账号 ID、Gateway ID 和 API Key。

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

json5

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

验证模型可用性

bash

openclaw models list --provider cloudflare-ai-gateway

非交互式配置

在脚本或 CI 环境中，可通过命令行直接传入所有参数：

bash

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 自身的认证机制。

json5

{
  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 怎么获取？ ​

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