OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Gateway IA de Cloudflare

Cloudflare AI Gateway se place devant les API des fournisseurs et ajoute des fonctions d’analyse, de mise en cache et de contrôle. Pour Anthropic, OpenClaw utilise l’API Anthropic Messages via votre point de terminaison Gateway.

Propriété Valeur
Fournisseur cloudflare-ai-gateway
Plugin paquet externe officiel (@openclaw/cloudflare-ai-gateway-provider)
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-6
Clé API CLOUDFLARE_AI_GATEWAY_API_KEY (votre clé API de fournisseur pour les requêtes transmises via le Gateway)

Lorsque le raisonnement est activé pour les modèles Anthropic Messages, OpenClaw supprime les tours de préremplissage finaux de l’assistant avant d’envoyer la charge utile via Cloudflare AI Gateway. Anthropic refuse le préremplissage des réponses avec le raisonnement étendu, tandis que le préremplissage ordinaire sans raisonnement reste disponible.

Installer le Plugin

Installez le Plugin officiel, puis redémarrez le Gateway :

bash
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restart

Prise en main

  • Définir la clé API du fournisseur et les informations du Gateway

    Lancez la configuration initiale et choisissez l’option d’authentification Cloudflare AI Gateway :

    bash
    openclaw onboard --auth-choice cloudflare-ai-gateway-api-key

    Vous serez invité à saisir votre identifiant de compte, l’identifiant du Gateway et votre clé API.

  • Définir un modèle par défaut

    Ajoutez le modèle à votre configuration OpenClaw :

    json5
    {  agents: {    defaults: {      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },    },  },}

  • Vérifier que le modèle est disponible

    bash
    openclaw models list --provider cloudflare-ai-gateway

    • Exemple non interactif

    Pour les configurations automatisées ou d’intégration continue, transmettez toutes les valeurs sur la ligne de commande :

    bash
    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"

    Configuration avancée

    Gateways authentifiés

    Si vous avez activé l’authentification du Gateway dans Cloudflare, ajoutez l’en-tête cf-aig-authorization. Celui-ci s’utilise en plus de votre clé API de fournisseur.

    json5
    {  models: {    providers: {      "cloudflare-ai-gateway": {        headers: {          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",        },      },    },  },}
    Remarque sur l’environnement

    Si le Gateway s’exécute en tant que démon (launchd/systemd), assurez-vous que CLOUDFLARE_AI_GATEWAY_API_KEY est accessible à ce processus.

    Ressources connexes

    Sélection du modèle

    Choix des fournisseurs, des références de modèles et du comportement de basculement.
    Dépannage

    Dépannage général et FAQ.
    Was this useful?
    On this page

    On this page