Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Vercel AI Gateway stellt eine einheitliche API bereit, um über einen einzigen Endpoint auf Hunderte von Modellen zuzugreifen.
EigenschaftWert
Providervercel-ai-gateway
AuthentifizierungAI_GATEWAY_API_KEY
APImit Anthropic 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

API-Schlüssel festlegen

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

Standardmodell festlegen

Fügen Sie das Modell 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 Skript- oder CI-Setups übergeben Sie alle Werte über die Befehlszeile:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

Kurzschreibweise für Modell-IDs

OpenClaw akzeptiert Vercel-Claude-Modell-Refs in Kurzschreibweise und normalisiert sie zur Laufzeit:
Eingabe in KurzschreibweiseNormalisierte 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 Kurzschreibweise 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) 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 ausdrücklich importiert wird. Setzen Sie den Schlüssel in ~/.openclaw/.env oder über env.shellEnv, um sicherzustellen, dass der Gateway-Prozess ihn lesen kann.
Vercel AI Gateway leitet Anfragen anhand des Modell-Ref-Präfixes 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 wird. 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 Upstream-Provider-Vertrag 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 namespacete Refs behalten die normalen Reasoning-Stufen bei, sofern ihre Katalogmetadaten nicht mehr deklarieren.

Verwandte Themen

Modellauswahl

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

Fehlerbehebung

Allgemeine Fehlerbehebung und FAQ.