Providers
Gateway AI di Cloudflare
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 |
|---|---|
| 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-6 |
| Chiave API | CLOUDFLARE_AI_GATEWAY_API_KEY (la tua chiave API del provider per le richieste tramite il 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.
Installa Plugin
Installa il Plugin ufficiale, quindi riavvia Gateway:
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restartPer iniziare
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-keyVerranno richiesti l'ID account, l'ID gateway e la chiave API.
Imposta un modello predefinito
Aggiungi il modello alla configurazione di OpenClaw:
{ agents: { defaults: { model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" }, }, },}Verifica che il modello sia disponibile
openclaw models list --provider cloudflare-ai-gatewayEsempio 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
Gateway autenticati
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>", }, }, }, },}Nota sull'ambiente
Se il Gateway viene eseguito come demone (launchd/systemd), assicurati che CLOUDFLARE_AI_GATEWAY_API_KEY sia disponibile per quel processo.
