Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Cloudflare AI Gateway se place devant les API des fournisseurs et vous permet d’ajouter des analytics, de la mise en cache et des contrôles. Pour Anthropic, OpenClaw utilise l’API Messages d’Anthropic via votre point de terminaison Gateway.
PropriétéValeur
Fournisseurcloudflare-ai-gateway
URL de basehttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Modèle par défautcloudflare-ai-gateway/claude-sonnet-4-6
Clé d’APICLOUDFLARE_AI_GATEWAY_API_KEY (votre clé d’API fournisseur pour les requêtes via le Gateway)
Pour les modèles Anthropic routés via Cloudflare AI Gateway, utilisez votre clé d’API Anthropic comme clé fournisseur.
Lorsque le mode de réflexion 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 rejette le préremplissage des réponses avec la réflexion étendue, tandis que le préremplissage ordinaire sans réflexion reste disponible.

​
Bien démarrer

1

Définir la clé d’API fournisseur et les détails du Gateway

Lancez l’onboarding et choisissez l’option d’authentification Cloudflare AI Gateway :
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Cela vous demande votre ID de compte, votre ID de Gateway et votre clé d’API.
2

Définir un modèle par défaut

Ajoutez le modèle à votre configuration OpenClaw :
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

Vérifier que le modèle est disponible

openclaw models list --provider cloudflare-ai-gateway

​
Exemple non interactif

Pour les configurations scriptées ou CI, passez toutes les valeurs sur la ligne de commande : 
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

Si vous avez activé l’authentification Gateway dans Cloudflare, ajoutez l’en-tête cf-aig-authorization. Cela s’ajoute à votre clé d’API fournisseur.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
L’en-tête cf-aig-authorization authentifie auprès du Gateway Cloudflare lui-même, tandis que la clé d’API fournisseur (par exemple, votre clé Anthropic) authentifie auprès du fournisseur en amont.
Si le Gateway s’exécute comme daemon (launchd/systemd), assurez-vous que CLOUDFLARE_AI_GATEWAY_API_KEY est disponible pour ce processus.
Une clé présente uniquement dans ~/.profile n’aidera pas un daemon launchd/systemd, sauf si cet environnement y est également importé. Définissez la clé dans ~/.openclaw/.env ou via env.shellEnv pour garantir que le processus Gateway peut la lire.

​
Liens connexes

Sélection du modèle

Choisir les fournisseurs, les références de modèles et le comportement de basculement.

Dépannage

Dépannage général et FAQ.