Vai al contenuto principale

​
Cloudflare AI Gateway

Cloudflare AI Gateway si colloca davanti alle API dei provider e ti consente di aggiungere analytics, caching e controlli. Per Anthropic, OpenClaw usa l’API Anthropic Messages tramite il tuo endpoint Gateway.
  • Provider: cloudflare-ai-gateway
  • URL di base: https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
  • Modello predefinito: cloudflare-ai-gateway/claude-sonnet-4-5
  • Chiave API: CLOUDFLARE_AI_GATEWAY_API_KEY (la tua chiave API del provider per le richieste tramite il Gateway)
Per i modelli Anthropic, usa la tua chiave API Anthropic.

​
Avvio rapido

  1. Imposta la chiave API del provider e i dettagli del Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
  1. Imposta un modello predefinito:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}

​
Esempio non interattivo

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"

​
Gateway autenticati

Se hai abilitato l’autenticazione Gateway in Cloudflare, aggiungi l’header cf-aig-authorization (questo si aggiunge alla chiave API del provider). 
{
  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 quel processo (ad esempio in ~/.openclaw/.env o tramite env.shellEnv).