openclaw models

Modell-Erkennung, -Scanning und -Konfiguration (Standardmodell, Fallbacks, Auth-Profile).

Verwandte Themen:

• Provider + Modelle: Models
• Provider-Authentifizierung einrichten: Getting started

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/Fallbacks sowie eine Auth-Übersicht. Wenn Provider-Nutzungs-Snapshots verfügbar sind, enthält der OAuth/Token-Statusbereich die Provider-Nutzungs-Header. Mit --probe werden Live-Auth-Prüfungen gegen jedes konfigurierte Provider-Profil durchgeführt. Probes sind echte Anfragen (können Tokens verbrauchen und Rate-Limits auslösen). Mit --agent <id> kannst du den Modell-/Auth-Status eines konfigurierten Agenten inspizieren. Ohne diese Option verwendet der Befehl OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR (falls gesetzt), andernfalls den konfigurierten Standard-Agenten.

Hinweise:

• models set <model-or-alias> akzeptiert provider/model oder einen Alias.
• Modell-Referenzen werden durch Aufteilen am ersten / geparst. Wenn die Modell-ID ein / enthält (OpenRouter-Stil), gib den Provider-Präfix an (Beispiel: openrouter/moonshotai/kimi-k2).
• Wenn du den Provider weglässt, behandelt OpenClaw die Eingabe als Alias oder als Modell für den Standard-Provider (funktioniert nur, wenn kein / in der Modell-ID enthalten ist).
• models status kann marker(<value>) in der Auth-Ausgabe für nicht-geheime Platzhalter anzeigen (zum Beispiel OPENAI_API_KEY, secretref-managed, minimax-oauth, qwen-oauth, ollama-local), anstatt sie als Secrets zu maskieren.

models status

Optionen:

• --json
• --plain
• --check (Exit 1=abgelaufen/fehlend, 2=bald ablaufend)
• --probe (Live-Prüfung der konfigurierten Auth-Profile)
• --probe-provider <name> (einen Provider prüfen)
• --probe-profile <id> (wiederholbar oder kommaseparierte Profil-IDs)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (konfigurierte Agenten-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). Verwende openclaw plugins list, um zu sehen, welche Provider installiert sind.

Hinweise:

• setup-token fordert zur Eingabe eines Setup-Token-Werts auf (generiere ihn mit claude setup-token auf einem beliebigen Rechner).
• paste-token akzeptiert einen Token-String, der anderweitig oder per Automatisierung generiert wurde.
• Anthropic-Richtlinienhinweis: Die Setup-Token-Unterstützung dient der technischen Kompatibilität. Anthropic hat in der Vergangenheit bestimmte Abo-Nutzungen außerhalb von Claude Code blockiert – prüfe daher die aktuellen Nutzungsbedingungen, bevor du es breit einsetzt.