Zum Hauptinhalt springen

​
Vercel AI Gateway

Das Vercel AI Gateway bietet eine einheitliche API, um über einen einzigen Endpunkt auf Hunderte Modelle zuzugreifen.
EigenschaftWert
Providervercel-ai-gateway
AuthAI_GATEWAY_API_KEY
APIAnthropic-Messages-kompatibel
ModellkatalogAutomatisch erkannt über /v1/models
OpenClaw erkennt den Gateway-Katalog /v1/models automatisch, daher enthält /models vercel-ai-gateway aktuelle Modell-Refs wie vercel-ai-gateway/openai/gpt-5.4.

​
Erste Schritte

1

Den API-Schlüssel setzen

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
2

Ein Standardmodell festlegen

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

Prüfen, ob das Modell verfügbar ist

openclaw models list --provider vercel-ai-gateway

​
Nicht interaktives Beispiel

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

​
Modell-ID-Kurzform

OpenClaw akzeptiert Kurzform-Modell-Refs für Vercel Claude 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 Hinweise

Wenn das OpenClaw Gateway als Daemon (launchd/systemd) läuft, stellen Sie sicher, dass AI_GATEWAY_API_KEY für diesen Prozess verfügbar ist.
Ein Schlüssel, der nur in ~/.profile gesetzt ist, ist für einen launchd/systemd- Daemon nicht sichtbar, sofern diese Umgebung nicht explizit importiert wird. Setzen Sie den Schlüssel in ~/.openclaw/.env oder über env.shellEnv, damit der Gateway-Prozess ihn lesen kann.
Vercel AI Gateway leitet Anfragen anhand des Präfixes der Modell-Ref an den Upstream-Provider weiter. Zum Beispiel wird vercel-ai-gateway/anthropic/claude-opus-4.6 über Anthropic geroutet, während vercel-ai-gateway/openai/gpt-5.4 über OpenAI geroutet wird. Ihr einzelner AI_GATEWAY_API_KEY übernimmt die Authentifizierung für alle Upstream-Provider.

​
Verwandt

Modellauswahl

Auswahl von Providern, Modell-Refs und Failover-Verhalten.

Fehlerbehebung

Allgemeine Fehlerbehebung und FAQ.