OpenClaw Models verwalten

Kennst du das? Du arbeitest an einem Projekt und musst ständig zwischen verschiedenen LLM-Providern wechseln. Mal ist ein API-Key abgelaufen, mal antwortet ein Model nicht, und am Ende verbringst du mehr Zeit mit der Konfiguration als mit dem eigentlichen Coding. Es nervt, wenn man nicht auf Anhieb sieht, welches Model gerade aktiv ist oder ob die Authentifizierung überhaupt noch steht.

Das Verwalten von Model-Konfigurationen, Fallbacks und Auth-Profilen sollte dich nicht aufhalten. Hier erfährst du, wie du mit der CLI den Überblick behältst und deine Umgebung schnell einrichtest.

Voraussetzungen

• Installierte Provider und Models
• Eingerichtetes Provider Auth Setup

Schnellstart

In weniger als 5 Minuten hast du deine Models im Griff. Nutze diese Befehle für den Einstieg:

1. Status prüfen:

   openclaw models status

   Zeigt dir die konfigurierten Default-Models, Fallbacks und eine Übersicht deiner Authentifizierung.

2. Verfügbare Models anzeigen:

   openclaw models list

3. Default Model festlegen:

   openclaw models set <model-or-alias>

   Du kannst provider/model (z. B. openrouter/moonshotai/kimi-k2) oder einen Alias verwenden. Wenn du den Provider weglässt, wird der Default-Provider genutzt.

4. Models scannen:

   openclaw models scan

Details zur Konfiguration

Authentifizierung prüfen

Der Befehl models status zeigt bei verfügbaren Provider-Snapshots auch OAuth- und Token-Informationen an. Manchmal siehst du Platzhalter wie marker(OPENAI_API_KEY) oder minimax-oauth anstelle von maskierten Secrets.

Wenn du sichergehen willst, dass deine Logins funktionieren, hänge --probe an:

openclaw models status --probe

Hinweis: Dies sendet echte Requests an die Provider, verbraucht Tokens und zählt gegen deine Rate Limits.

Auth-Profile verwalten

Um neue Provider hinzuzufügen oder dich einzuloggen, nutzt du diese Befehle:

• openclaw models auth login --provider <id>: Startet den Auth-Flow (OAuth oder API-Key) eines Plugins.
• openclaw models auth setup-token: Fragt nach einem Setup-Token (praktisch für die Synchronisation zwischen Maschinen).
• openclaw models auth paste-token: Erlaubt das manuelle Einfügen eines Tokens.

Wichtig für Anthropic-Nutzer: Die Unterstützung für setup-token ist technisch vorhanden. Beachte jedoch, dass Anthropic in der Vergangenheit die Nutzung außerhalb von Claude Code eingeschränkt hat. Prüfe vorab die aktuellen Bedingungen.

Fehlerbehebung

• Token-Status unklar: Nutze openclaw models status --check. Die CLI gibt Exit-Code 1 zurück, wenn Credentials fehlen oder abgelaufen sind, und Exit-Code 2, wenn sie bald ablaufen.
• Model wird nicht gefunden: Wenn dein Model-ID einen / enthält (wie bei OpenRouter), musst du den Provider-Präfix zwingend mit angeben (z. B. openrouter/moonshotai/kimi-k2), damit der Parser den Namen korrekt trennt.
• Agent-Konfiguration prüfen: Wenn du den Status eines spezifischen Agents untersuchen willst, nutze --agent <id>. Ansonsten verwendet die CLI die Umgebungsvariablen OPENCLAW_AGENT_DIR oder PI_CODING_AGENT_DIR.

Du hast Fragen zu einem speziellen Setup? Der AI Setup Assistant hilft dir direkt weiter.

Nächste Schritte

• Providers + Models Details
• Provider Auth Setup Guide
• Plugins verwalten