Zum Hauptinhalt springen
Der Vercel AI Gateway stellt eine einheitliche API bereit, um über einen einzelnen Endpunkt auf Hunderte von Modellen zuzugreifen.
EigenschaftWert
Providervercel-ai-gateway
Paket@openclaw/vercel-ai-gateway-provider
AuthAI_GATEWAY_API_KEY
APIAnthropic Messages-kompatibel
ModellkatalogAutomatisch über /v1/models erkannt
OpenClaw erkennt den Gateway-Katalog /v1/models automatisch, sodass /models vercel-ai-gateway aktuelle Modell-Refs wie vercel-ai-gateway/openai/gpt-5.5 und vercel-ai-gateway/moonshotai/kimi-k2.6 enthält.

​
Erste Schritte

1

Plugin installieren

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

API-Schlüssel festlegen

Führen Sie das Onboarding aus und wählen Sie die Auth-Option für AI Gateway:
openclaw onboard --auth-choice ai-gateway-api-key
3

Ein Standardmodell festlegen

Fügen Sie das Modell Ihrer OpenClaw-Konfiguration hinzu:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
4

Prüfen, ob das Modell verfügbar ist

openclaw models list --provider vercel-ai-gateway

​
Nicht interaktives Beispiel

Für skriptgesteuerte oder CI-Setups übergeben Sie alle Werte in der Befehlszeile: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

​
Kurzform für Modell-IDs

OpenClaw akzeptiert Vercel-Claude-Kurzform-Modell-Refs und normalisiert sie zur Laufzeit:
Kurzform-EingabeNormalisierte Modell-Ref
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
Sie können in Ihrer Konfiguration entweder die Kurzform oder die vollständig qualifizierte Modell-Ref verwenden. OpenClaw löst die kanonische Form automatisch auf.

​
Erweiterte Konfiguration

Wenn der OpenClaw Gateway als Daemon (launchd/systemd) ausgeführt wird, stellen Sie sicher, dass AI_GATEWAY_API_KEY für diesen Prozess verfügbar ist.
Ein Schlüssel, der nur in einer interaktiven Shell exportiert wurde, ist für einen launchd/systemd-Daemon nur sichtbar, wenn diese Umgebung ausdrücklich importiert wird. Legen Sie den Schlüssel in ~/.openclaw/.env oder über env.shellEnv fest, damit der Gateway-Prozess ihn lesen kann.
Vercel AI Gateway leitet Anfragen basierend auf dem Präfix der Modell-Ref an den Upstream-Provider weiter. Beispielsweise wird vercel-ai-gateway/anthropic/claude-opus-4.6 über Anthropic geroutet, während vercel-ai-gateway/openai/gpt-5.5 über OpenAI und vercel-ai-gateway/moonshotai/kimi-k2.6 über MoonshotAI geroutet werden. Ihr einzelner AI_GATEWAY_API_KEY übernimmt die Authentifizierung für alle Upstream-Provider.
/think-Optionen folgen vertrauenswürdigen Upstream-Modellpräfixen, wenn OpenClaw den Vertrag des Upstream-Providers kennt. vercel-ai-gateway/anthropic/... verwendet das Claude-Thinking-Profil, einschließlich adaptiver Standardwerte für Claude-4.6-Modelle. vercel-ai-gateway/openai/gpt-5.4, gpt-5.5 und Codex-artige Refs stellen /think xhigh genau wie die direkten OpenAI/OpenAI Codex-Provider bereit. Andere namespacede Refs behalten die normalen Reasoning-Stufen bei, sofern ihre Katalogmetadaten nicht mehr deklarieren.

​
Verwandt

Modellauswahl

Provider, Modell-Refs und Failover-Verhalten auswählen.

Problembehandlung

Allgemeine Problembehandlung und FAQ.