Passerelle AI Cloudflare

La passerelle AI Cloudflare se situe devant les API des fournisseurs et vous permet d’ajouter des analyses, de la mise en cache et des contrôles. Pour Anthropic, OpenClaw utilise l’API de messages Anthropic via votre point de terminaison de passerelle.

Propriété	Valeur
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-6`
Clé API	`CLOUDFLARE_AI_GATEWAY_API_KEY` (votre clé API de fournisseur pour les requêtes via la passerelle)

Lorsque la réflexion est activée pour les modèles Messages Anthropic, OpenClaw supprime les tours de préremplissage de l’assistant à la fin 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.

Getting started

Définir la clé API du fournisseur et les détails du Gateway
Exécutez le onboarding et choisissez l’option d’authentification Cloudflare AI Gateway :
Fenêtre de terminal
```
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
```
Cela vous demande votre identifiant de compte, votre identifiant de passerelle (gateway ID) et votre clé API.

Définir un model par défaut

Ajoutez le model à votre configuration OpenClaw :

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

Vérifiez que le modèle est disponible
Fenêtre de terminal
```
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

Passerelles authentifiées

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

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer

”, }, }, }, }, } ```

Note 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 disponible pour ce processus.

Connexes

Sélection du modèle

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

Résolution de problèmes

Résolution de problèmes généraux et FAQ.