Pular para o conteúdo principal
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 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-6
Chave de APICLOUDFLARE_AI_GATEWAY_API_KEY (sua chave de API do provedor para solicitações pelo Gateway)
Para modelos Anthropic roteados pelo Cloudflare AI Gateway, use sua chave de API da Anthropic como a chave do provedor.
Quando o pensamento está habilitado para modelos Anthropic Messages, o OpenClaw remove turnos finais de preenchimento prévio do assistente antes de enviar a carga pelo Cloudflare AI Gateway. A Anthropic rejeita o preenchimento prévio de respostas com pensamento estendido, enquanto o preenchimento prévio comum sem pensamento continua disponível.

​
Instalar Plugin

Instale o Plugin oficial e reinicie o Gateway: 
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​
Primeiros passos

1

Set the provider API key and Gateway details

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

Set a default model

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

Verify the model is available

openclaw models list --provider cloudflare-ai-gateway

​
Exemplo não interativo

Para configurações com scripts ou CI, passe todos os valores na 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 a autenticação do Gateway na Cloudflare, adicione o cabeçalho cf-aig-authorization. Isso é além da sua chave de API do provedor.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
O cabeçalho cf-aig-authorization autentica com o próprio Cloudflare Gateway, enquanto a chave de API do provedor (por exemplo, sua chave da Anthropic) autentica com o provedor upstream.
Se o Gateway for executado como daemon (launchd/systemd), confirme que CLOUDFLARE_AI_GATEWAY_API_KEY esteja disponível para esse processo.
Uma chave exportada apenas em um shell interativo não ajudará um daemon launchd/systemd, a menos que esse ambiente também seja importado nele. Defina a chave em ~/.openclaw/.env ou via env.shellEnv para garantir que o processo do gateway consiga lê-la.

​
Relacionado

Model selection

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

Troubleshooting

Solução de problemas geral e perguntas frequentes.