Pular para o conteúdo principal

​
Cloudflare AI Gateway

O Cloudflare AI Gateway fica na frente das APIs de 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.
PropriedadeValor
Provedorcloudflare-ai-gateway
URL basehttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Modelo padrãocloudflare-ai-gateway/claude-sonnet-4-5
Chave de APICLOUDFLARE_AI_GATEWAY_API_KEY (sua chave de API do provedor para solicitações pelo Gateway)
Para modelos da Anthropic roteados pelo Cloudflare AI Gateway, use sua chave de API da Anthropic como chave do provedor.

​
Primeiros passos

1

Defina a chave de API do provedor e os detalhes do Gateway

Execute o onboarding e escolha a opção de autenticação do Cloudflare AI Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Isso solicitará seu ID da conta, ID do Gateway e chave de API.
2

Defina um modelo padrão

Adicione o modelo à sua configuração do OpenClaw:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}
3

Verifique se o modelo está disponível

openclaw models list --provider cloudflare-ai-gateway

​
Exemplo não interativo

Para configurações por script ou CI, passe todos os valores pela linha de comando: 
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"

​
Configuração avançada

Se você habilitou autenticação do Gateway no Cloudflare, adicione o header cf-aig-authorization. Isso é além de sua chave de API do provedor.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
O header cf-aig-authorization autentica no próprio Cloudflare Gateway, enquanto a chave de API do provedor (por exemplo, sua chave da Anthropic) autentica no provedor upstream.
Se o Gateway for executado como daemon (launchd/systemd), certifique-se de que CLOUDFLARE_AI_GATEWAY_API_KEY esteja disponível para esse processo.
Uma chave presente apenas em ~/.profile não ajudará um daemon launchd/systemd, a menos que esse ambiente também seja importado ali. Defina a chave em ~/.openclaw/.env ou via env.shellEnv para garantir que o processo do gateway consiga lê-la.

​
Relacionado

Seleção de modelo

Escolha de provedores, refs de modelo e comportamento de failover.

Solução de problemas

Solução geral de problemas e FAQ.