Vai al contenuto principale

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 si pone davanti alle API dei provider e consente di aggiungere analytics, caching e controlli. Per Anthropic, OpenClaw usa l’API Anthropic Messages tramite il tuo endpoint Gateway.
ProprietàValore
Fornitorecloudflare-ai-gateway
URL di basehttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Modello predefinitocloudflare-ai-gateway/claude-sonnet-4-6
Chiave APICLOUDFLARE_AI_GATEWAY_API_KEY (la chiave API del tuo provider per le richieste tramite il Gateway)
Per i modelli Anthropic instradati tramite Cloudflare AI Gateway, usa la tua chiave API Anthropic come chiave del provider.
Quando il thinking è abilitato per i modelli Anthropic Messages, OpenClaw rimuove i turni finali di prefill dell’assistente prima di inviare il payload tramite Cloudflare AI Gateway. Anthropic rifiuta il prefill delle risposte con extended thinking, mentre il normale prefill senza thinking rimane disponibile.

​
Introduzione

1

Imposta la chiave API del provider e i dettagli del Gateway

Esegui l’onboarding e scegli l’opzione di autenticazione Cloudflare AI Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Questo richiede il tuo ID account, ID gateway e chiave API.
2

Imposta un modello predefinito

Aggiungi il modello alla tua configurazione OpenClaw:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

Verifica che il modello sia disponibile

openclaw models list --provider cloudflare-ai-gateway

​
Esempio non interattivo

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

​
Configurazione avanzata

Se hai abilitato l’autenticazione del Gateway in Cloudflare, aggiungi l’header cf-aig-authorization. Questo è in aggiunta a la chiave API del tuo provider.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
L’header cf-aig-authorization autentica con il Cloudflare Gateway stesso, mentre la chiave API del provider (per esempio la tua chiave Anthropic) autentica con il provider upstream.
Se il Gateway viene eseguito come daemon (launchd/systemd), assicurati che CLOUDFLARE_AI_GATEWAY_API_KEY sia disponibile per quel processo.
Una chiave presente solo in ~/.profile non aiuterà un daemon launchd/systemd a meno che quell’ambiente non venga importato anche lì. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per garantire che il processo Gateway possa leggerla.

​
Correlati

Selezione del modello

Scelta dei provider, riferimenti dei modelli e comportamento di failover.

Risoluzione dei problemi

Risoluzione generale dei problemi e FAQ.