Passer au contenu principal

​
Vercel AI Gateway

Le Vercel AI Gateway fournit une API unifiée pour accéder à des centaines de modèles via un point de terminaison unique.
PropriétéValeur
Fournisseurvercel-ai-gateway
AuthentificationAI_GATEWAY_API_KEY
APICompatible Anthropic Messages
Catalogue de modèlesDécouvert automatiquement via /v1/models
OpenClaw découvre automatiquement le catalogue Gateway /v1/models, donc /models vercel-ai-gateway inclut des références de modèles actuelles comme vercel-ai-gateway/openai/gpt-5.4.

​
Prise en main

1

Définir la clé API

Lancez l’onboarding et choisissez l’option d’authentification AI Gateway :
openclaw onboard --auth-choice ai-gateway-api-key
2

Définir un modèle par défaut

Ajoutez le modèle à votre configuration OpenClaw :
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
3

Vérifier que le modèle est disponible

openclaw models list --provider vercel-ai-gateway

​
Exemple non interactif

Pour des configurations scriptées ou de CI, passez toutes les valeurs sur la ligne de commande : 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

​
Raccourci d’ID de modèle

OpenClaw accepte des références de modèle Claude abrégées Vercel et les normalise à l’exécution :
Entrée abrégéeRéférence de modèle normalisée
vercel-ai-gateway/claude-opus-4.6vercel-ai-gateway/anthropic/claude-opus-4.6
vercel-ai-gateway/opus-4.6vercel-ai-gateway/anthropic/claude-opus-4-6
Vous pouvez utiliser soit la forme abrégée, soit la référence de modèle pleinement qualifiée dans votre configuration. OpenClaw résout automatiquement la forme canonique.

​
Notes avancées

Si la passerelle OpenClaw s’exécute comme daemon (launchd/systemd), assurez-vous que AI_GATEWAY_API_KEY est disponible pour ce processus.
Une clé définie uniquement dans ~/.profile ne sera pas visible pour un daemon launchd/systemd à moins que cet environnement ne soit explicitement importé. Définissez la clé dans ~/.openclaw/.env ou via env.shellEnv pour vous assurer que le processus de la passerelle peut la lire.
Vercel AI Gateway route les requêtes vers le fournisseur upstream en fonction du préfixe de la référence de modèle. Par exemple, vercel-ai-gateway/anthropic/claude-opus-4.6 est routé via Anthropic, tandis que vercel-ai-gateway/openai/gpt-5.4 est routé via OpenAI. Votre unique AI_GATEWAY_API_KEY gère l’authentification pour tous les fournisseurs upstream.

​
Voir aussi

Sélection de 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.