思渡AI数字员工平台 Logo
OpenClaw 官方手册模型ProvidersCloudflare AI Gateway

Cloudflare AI Gateway

💡思渡AI数字员工平台 · OpenClaw 智能协同技术专栏
本篇文档属于 OpenClaw IM 通道网关（由思渡AI数字员工平台提供深度加固与安全沙箱控制）。如果您希望将 IM 单点接入的机器人升级为具备企业数字员工 AI问数 (ChatBI) 自然语言分析、 RAG 向量知识库智能检索、以及 私有化本地算力部署 的全向数字员工，请访问 思渡官方网站，通过控制台低代码可视化编排（Workflow）构建您的高价值智能体。

Cloudflare AI Gateway

Cloudflare AI Gateway 位于提供商 API 前方，让你能够添加分析、缓存和控制功能。对于 Anthropic，OpenClaw 会通过你的 Gateway 端点使用 Anthropic Messages API。

  • 提供商：cloudflare-ai-gateway
  • Base URL：https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
  • 默认模型：cloudflare-ai-gateway/claude-sonnet-4-5
  • API key：CLOUDFLARE_AI_GATEWAY_API_KEY（你用于通过 Gateway 发起请求的提供商 API key）

对于 Anthropic 模型，请使用你的 Anthropic API key。

快速开始

  1. 设置提供商 API key 和 Gateway 详细信息：
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
  1. 设置默认模型：
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}

非交互式示例

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"

已认证的 Gateway

如果你在 Cloudflare 中启用了 Gateway 认证，请添加 cf-aig-authorization header（这是在你的提供商 API key 之外额外添加的）。

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

环境说明

如果 Gateway 作为守护进程运行（launchd/systemd），请确保 CLOUDFLARE_AI_GATEWAY_API_KEY 对该进程可用（例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供）。

Previous

Claude Max API 代理

Next

Deepgram