Passer au contenu principal

​
Cloudflare AI Gateway

Cloudflare AI Gateway se place devant les API des fournisseurs et vous permet d’ajouter de l’analytique, du cache et des contrôles. Pour Anthropic, OpenClaw utilise l’API Anthropic Messages via votre point de terminaison Gateway.
  • Fournisseur : cloudflare-ai-gateway
  • URL de base : https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
  • Modèle par défaut : cloudflare-ai-gateway/claude-sonnet-4-5
  • Clé API : CLOUDFLARE_AI_GATEWAY_API_KEY (votre clé API fournisseur pour les requêtes passant par la gateway)
Pour les modèles Anthropic, utilisez votre clé API Anthropic.

​
Démarrage rapide

  1. Définissez la clé API du fournisseur et les détails de la gateway :
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
  1. Définissez un modèle par défaut :
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}

​
Exemple non interactif

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"

​
Gateways authentifiées

Si vous avez activé l’authentification Gateway dans Cloudflare, ajoutez l’en-tête cf-aig-authorization (en plus de votre clé API fournisseur). 
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

​
Remarque sur l’environnement

Si la gateway s’exécute comme daemon (launchd/systemd), assurez-vous que CLOUDFLARE_AI_GATEWAY_API_KEY est disponible pour ce processus (par exemple dans ~/.openclaw/.env ou via env.shellEnv).