Providers
Gateway de IA da Cloudflare
Cloudflare AI Gateway fica na frente das APIs dos provedores e permite adicionar análises, cache e controles. Para a Anthropic, o OpenClaw usa a API Anthropic Messages por meio do endpoint do seu Gateway.
| Propriedade | Valor |
|---|---|
| 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-6 |
| Chave de API | CLOUDFLARE_AI_GATEWAY_API_KEY (sua chave de API do provedor para solicitações pelo Gateway) |
Quando o raciocínio está ativado para modelos Anthropic Messages, o OpenClaw remove turnos finais de pré-preenchimento do assistente antes de enviar a carga útil pelo Cloudflare AI Gateway. A Anthropic rejeita o pré-preenchimento de respostas com raciocínio estendido, enquanto o pré-preenchimento comum sem raciocínio permanece disponível.
Primeiros passos
Defina a chave de API do provedor e os detalhes do Gateway
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 seu ID da conta, ID do Gateway e chave de API.
Defina um modelo padrão
Adicione o modelo à configuração do OpenClaw:
{
agents: {
defaults: {
model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
},
},
}
Verifique se o modelo está disponível
openclaw models list --provider cloudflare-ai-gateway
Exemplo não interativo
Para configurações com script 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
Gateways autenticados
Se você habilitou a autenticação do Gateway no 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>",
},
},
},
},
}
Observação sobre o ambiente
Se o Gateway for executado como um daemon (launchd/systemd), garanta que CLOUDFLARE_AI_GATEWAY_API_KEY esteja disponível para esse processo.