Passer au contenu principal
Le Vercel AI Gateway fournit une API unifiée pour accéder à des centaines de modèles via un seul point de terminaison.
PropriétéValeur
Fournisseurvercel-ai-gateway
Package@openclaw/vercel-ai-gateway-provider
AuthentificationAI_GATEWAY_API_KEY
APICompatible avec Anthropic Messages
Catalogue de modèlesDécouvert automatiquement via /v1/models
OpenClaw découvre automatiquement le catalogue /v1/models du Gateway, donc /models vercel-ai-gateway inclut les références de modèles actuelles comme vercel-ai-gateway/openai/gpt-5.5 et vercel-ai-gateway/moonshotai/kimi-k2.6.

Bien démarrer

1

Installer le Plugin

openclaw plugins install @openclaw/vercel-ai-gateway-provider
2

Définir la clé API

Exécutez l’onboarding et choisissez l’option d’authentification AI Gateway :
openclaw onboard --auth-choice ai-gateway-api-key
3

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" },
    },
  },
}
4

Vérifier que le modèle est disponible

openclaw models list --provider vercel-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 ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

Raccourci d’ID de modèle

OpenClaw accepte les références abrégées de modèles Vercel Claude 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 la référence abrégée ou la référence de modèle entièrement qualifiée dans votre configuration. OpenClaw résout automatiquement la forme canonique.

Configuration avancée

Si le Gateway OpenClaw s’exécute comme un démon (launchd/systemd), assurez-vous que AI_GATEWAY_API_KEY est disponible pour ce processus.
Une clé exportée uniquement dans un shell interactif ne sera pas visible par un démon launchd/systemd, sauf si cet environnement est explicitement importé. Définissez la clé dans ~/.openclaw/.env ou via env.shellEnv afin de garantir que le processus Gateway puisse la lire.
Vercel AI Gateway achemine les requêtes vers le fournisseur amont en fonction du préfixe de la référence de modèle. Par exemple, vercel-ai-gateway/anthropic/claude-opus-4.6 passe par Anthropic, tandis que vercel-ai-gateway/openai/gpt-5.5 passe par OpenAI et vercel-ai-gateway/moonshotai/kimi-k2.6 passe par MoonshotAI. Votre unique AI_GATEWAY_API_KEY gère l’authentification pour tous les fournisseurs amont.
Les options /think suivent les préfixes de modèles amont approuvés lorsque OpenClaw connaît le contrat du fournisseur amont. vercel-ai-gateway/anthropic/... utilise le profil de réflexion Claude, y compris les valeurs adaptatives par défaut pour les modèles Claude 4.6. vercel-ai-gateway/openai/gpt-5.4, gpt-5.5 et les références de style Codex exposent /think xhigh comme les fournisseurs directs OpenAI/OpenAI Codex. Les autres références avec espace de noms conservent les niveaux de raisonnement normaux, sauf si les métadonnées de leur catalogue en déclarent davantage.

Associé

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.