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

Providers

Gateway AI di Cloudflare

Cloudflare AI Gateway si posiziona davanti alle API dei provider e aggiunge analisi, memorizzazione nella cache e controlli. Per Anthropic, OpenClaw utilizza l'API Anthropic Messages tramite l'endpoint del Gateway.

Proprietà Valore
Provider cloudflare-ai-gateway
Plugin pacchetto esterno ufficiale (@openclaw/cloudflare-ai-gateway-provider)
URL di base https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Modello predefinito cloudflare-ai-gateway/claude-sonnet-4-6
Chiave API CLOUDFLARE_AI_GATEWAY_API_KEY (la chiave API del provider per le richieste effettuate tramite Gateway)

Quando il ragionamento è abilitato per i modelli Anthropic Messages, OpenClaw rimuove i turni finali di precompilazione dell'assistente prima di inviare il payload tramite Cloudflare AI Gateway. Anthropic rifiuta la precompilazione della risposta con il ragionamento esteso, mentre la normale precompilazione senza ragionamento rimane disponibile.

Installare il Plugin

Installa il Plugin ufficiale, quindi riavvia Gateway:

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

Guida introduttiva

  • Impostare la chiave API del provider e i dettagli del Gateway

    Avvia la configurazione iniziale e scegli l'opzione di autenticazione Cloudflare AI Gateway:

    bash
    openclaw onboard --auth-choice cloudflare-ai-gateway-api-key

    Verranno richiesti l'ID dell'account, l'ID del gateway e la chiave API.

  • Impostare un modello predefinito

    Aggiungi il modello alla configurazione di OpenClaw:

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

  • Verificare che il modello sia disponibile

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

    • Esempio non interattivo

    Per configurazioni tramite script o CI, passa tutti i valori dalla riga di 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"

    Configurazione avanzata

    Gateway autenticati

    Se hai abilitato l'autenticazione del Gateway in Cloudflare, aggiungi l'header cf-aig-authorization. Questo è necessario in aggiunta alla chiave API del provider.

    json5
    {  models: {    providers: {      "cloudflare-ai-gateway": {        headers: {          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",        },      },    },  },}
    Nota sull'ambiente

    Se il Gateway viene eseguito come daemon (launchd/systemd), assicurati che CLOUDFLARE_AI_GATEWAY_API_KEY sia disponibile per tale processo.

    Contenuti correlati

    Selezione del modello

    Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.
    Risoluzione dei problemi

    Risoluzione generale dei problemi e domande frequenti.
    Was this useful?
    On this page

    On this page