Vai al contenuto principale
Cloudflare AI Gateway si colloca davanti alle API dei provider e consente di aggiungere analisi, caching e controlli. Per Anthropic, OpenClaw usa l’API Anthropic Messages tramite il tuo endpoint Gateway.
ProprietàValore
Providercloudflare-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 tua chiave API del 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 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.

​
Installa Plugin

Installa il Plugin ufficiale, quindi riavvia Gateway: 
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​
Per iniziare

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
Verranno richiesti l’ID account, l’ID gateway e la chiave API.
2

Imposta un modello predefinito

Aggiungi il modello alla configurazione di 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 con script o CI, passa tutti i valori sulla 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 Gateway in Cloudflare, aggiungi l’header cf-aig-authorization. Questo è in aggiunta a la tua chiave API del 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 (ad esempio, la tua chiave Anthropic) autentica con il provider upstream.
Se il Gateway viene eseguito come demone (launchd/systemd), assicurati che CLOUDFLARE_AI_GATEWAY_API_KEY sia disponibile per quel processo.
Una chiave esportata solo in una shell interattiva non aiuterà un demone launchd/systemd, a meno che quell’ambiente non venga importato anche lì. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per assicurarti che il processo gateway possa leggerla.

​
Correlati

Selezione del modello

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

Risoluzione dei problemi

Risoluzione generale dei problemi e FAQ.