Pular para o conteúdo principal

Cloudflare AI Gateway

O Cloudflare AI Gateway fica na frente das APIs dos provedores e permite adicionar análises, cache e controles. Para Anthropic, o OpenClaw usa a API Anthropic Messages por meio do endpoint do seu Gateway.
  • Provedor: cloudflare-ai-gateway
  • URL base: https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
  • Modelo padrão: cloudflare-ai-gateway/claude-sonnet-4-5
  • Chave de API: CLOUDFLARE_AI_GATEWAY_API_KEY (sua chave de API do provedor para solicitações por meio do Gateway)
Para modelos Anthropic, use sua chave de API da Anthropic.

Início rápido

  1. Defina a chave de API do provedor e os detalhes do Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
  1. Defina um modelo padrão:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}

Exemplo não interativo

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"

Gateways autenticados

Se você ativou a autenticação do Gateway no Cloudflare, adicione o header cf-aig-authorization (isso é adicional à sua chave de API do provedor).
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

Observação sobre ambiente

Se o Gateway for executado como daemon (launchd/systemd), verifique se CLOUDFLARE_AI_GATEWAY_API_KEY está disponível para esse processo (por exemplo, em ~/.openclaw/.env ou via env.shellEnv).