Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
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 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

1

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.
2

Defina um modelo padrão

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

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

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>",
        },
      },
    },
  },
}
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 um daemon (launchd/systemd), garanta 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 possa lê-la.

​
Relacionado

Seleção de modelo

Escolha de provedores, referências de modelo e comportamento de failover.

Solução de problemas

Solução de problemas geral e perguntas frequentes.