OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Gateway de IA da Cloudflare

Cloudflare AI Gateway fica na frente das APIs dos provedores e adiciona 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
Plugin pacote externo oficial (@openclaw/cloudflare-ai-gateway-provider)
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 por meio do Gateway)

Quando o raciocínio está habilitado para modelos Anthropic Messages, o OpenClaw remove os turnos finais de preenchimento prévio do assistente antes de enviar a carga por meio do Cloudflare AI Gateway. A Anthropic rejeita o preenchimento prévio de respostas com raciocínio estendido, enquanto o preenchimento prévio comum sem raciocínio continua disponível.

Instalar o Plugin

Instale o Plugin oficial e reinicie o Gateway:

bash
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restart

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:

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

  • Defina um modelo padrão

    Adicione o modelo à configuração do OpenClaw:

    json5
    {  agents: {    defaults: {      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },    },  },}

  • Verifique se o modelo está disponível

    bash
    openclaw models list --provider cloudflare-ai-gateway

    • Exemplo não interativo

    Para configurações automatizadas ou de CI, passe todos os valores na linha de comando:

    bash
    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 na Cloudflare, adicione o cabeçalho cf-aig-authorization. Isso é necessário além da chave de API do provedor.

    json5
    {  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 daemon (launchd/systemd), verifique se CLOUDFLARE_AI_GATEWAY_API_KEY está disponível para esse processo.

    Relacionados

    Seleção de modelos

    Como escolher provedores, referências de modelos e o comportamento de failover.
    Solução de problemas

    Solução geral de problemas e perguntas frequentes.
    Was this useful?
    On this page

    On this page