openclaw models

Modelle finden, scannen und konfigurieren (Standardmodell, Fallbacks, Auth-Profile).

Verwandte Themen:

Häufige Befehle

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

openclaw models status zeigt das aufgelöste Standardmodell und die Fallbacks sowie eine Auth-Übersicht. Wenn Provider-Nutzungsdaten verfügbar sind, enthält der OAuth/Token-Status auch die Provider-Nutzungsheader. Mit --probe führst du Live-Auth-Tests gegen jedes konfigurierte Provider-Profil durch. Probes sind echte Anfragen (können Token verbrauchen und Rate-Limits auslösen). Mit --agent <id> prüfst du den Modell-/Auth-Status eines konfigurierten Agents. Ohne diese Option verwendet der Befehl OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR (falls gesetzt), sonst den konfigurierten Standard-Agent.

Hinweise:

  • models set <model-or-alias> akzeptiert provider/model oder einen Alias.
  • Model-Refs werden am ersten / aufgeteilt. Wenn die Model-ID ein / enthält (OpenRouter-Stil), gib das Provider-Präfix mit an (Beispiel: openrouter/moonshotai/kimi-k2).
  • Ohne Provider-Angabe behandelt OpenClaw die Eingabe als Alias oder als Modell für den Standard-Provider (funktioniert nur, wenn kein / in der Model-ID ist).

models status

Optionen:

  • --json
  • --plain
  • --check (Exit-Code 1=abgelaufen/fehlt, 2=läuft bald ab)
  • --probe (Live-Test der konfigurierten Auth-Profile)
  • --probe-provider <name> (nur einen Provider testen)
  • --probe-profile <id> (wiederholbar oder kommagetrennte Profil-IDs)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>
  • --agent <id> (konfigurierte Agent-ID; überschreibt OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)

Aliase + Fallbacks

openclaw models aliases list
openclaw models fallbacks list

Auth-Profile

openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token
openclaw models auth paste-token

models auth login startet den Auth-Flow eines Provider-Plugins (OAuth/API-Key). Mit openclaw plugins list siehst du, welche Provider installiert sind.

Hinweise:

  • setup-token fragt nach einem Setup-Token-Wert (generiere ihn mit claude setup-token auf einem beliebigen Rechner).
  • paste-token akzeptiert einen Token-String, der woanders oder durch Automatisierung generiert wurde.