OpenClaw Model Failover: Fehler beheben & Konfiguration
Es gibt kaum etwas Frustrierenderes, als wenn deine API-Anfragen ins Leere laufen, nur weil ein Provider gerade ein technisches Problem hat oder du ein Rate-Limit erreicht hast. Damit dein Workflow nicht unterbrochen wird, braucht dein System eine intelligente Strategie, um Ausfälle abzufangen.
In diesem Guide erfährst du, wie OpenClaw mit solchen Situationen umgeht und wie du typische Fehlermeldungen bei den Credentials schnell löst.
Model Failover
Abschnitt betitelt „Model Failover“Verstehe und behebe Probleme beim Model Failover.
Wie funktioniert Failover?
Abschnitt betitelt „Wie funktioniert Failover?“Failover läuft in zwei Phasen ab:
- Auth profile rotation innerhalb desselben Providers.
- Model fallback auf das nächste Modell in
agents.defaults.model.fallbacks.
Für fehlerhafte Profile werden Cooldowns (Exponential Backoff) angewendet. So kann OpenClaw weiterhin antworten, selbst wenn ein Provider überlastet ist oder temporär ausfällt.
Was bedeutet “No credentials found for profile ‘anthropic:default’”?
Abschnitt betitelt „Was bedeutet “No credentials found for profile ‘anthropic:default’”?“Das bedeutet, dass das System versucht hat, die Auth-Profil-ID anthropic:default zu nutzen, aber keine passenden Credentials im erwarteten Auth-Store finden konnte.
Checkliste zur Behebung von “No credentials found for profile anthropic:default”
Abschnitt betitelt „Checkliste zur Behebung von “No credentials found for profile anthropic:default”“-
Prüfe den Speicherort der Auth-Profile:
- Aktuell:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json - Legacy:
~/.openclaw/agent/*(wird durchopenclaw doctormigriert)
- Aktuell:
-
Bestätige, dass deine Umgebungsvariablen vom Gateway geladen werden:
- Falls du
ANTHROPIC_API_KEYin deiner Shell setzt, das Gateway aber via systemd/launchd ausführst, wird die Variable eventuell nicht übernommen. - Hinterlege sie in
~/.openclaw/.envoder aktiviereenv.shellEnv.
- Falls du
-
Stelle sicher, dass du den richtigen Agent bearbeitest:
- Bei Multi-Agent-Setups können mehrere
auth-profiles.jsonDateien existieren.
- Bei Multi-Agent-Setups können mehrere
-
Überprüfe den Status von Modell und Auth:
Terminal-Fenster openclaw models status
Checkliste zur Behebung von “No credentials found for profile anthropic”
Abschnitt betitelt „Checkliste zur Behebung von “No credentials found for profile anthropic”“Diese Meldung erscheint, wenn der Run fest an ein Anthropic-Profil gebunden ist, das Gateway dieses aber nicht finden kann.
Nutze einen setup-token:
claude setup-tokenopenclaw models auth setup-token --provider anthropicFalls du stattdessen einen API-Key nutzen willst:
- Hinterlege
ANTHROPIC_API_KEYin~/.openclaw/.envauf dem Gateway-Host. - Lösche eine eventuell fixierte Reihenfolge:
Terminal-Fenster openclaw models auth order clear --provider anthropic - Prüfe, ob du Befehle auf dem Gateway-Host ausführst. Im Remote-Modus liegen Auth-Profile auf der Gateway-Maschine, nicht auf deinem Laptop.
Warum wurde auch Google Gemini versucht und ist fehlgeschlagen?
Abschnitt betitelt „Warum wurde auch Google Gemini versucht und ist fehlgeschlagen?“Wenn deine Modell-Konfiguration Google Gemini als Fallback enthält (oder du zu einem Gemini-Shorthand gewechselt hast), versucht OpenClaw dies während des Model fallback. Falls du keine Google-Credentials konfiguriert hast, erscheint die Meldung No API key found for provider "google".
Lösung: Entweder Google-Auth konfigurieren oder Google-Modelle aus agents.defaults.model.fallbacks entfernen.
Nächste Schritte
Abschnitt betitelt „Nächste Schritte“OpenClaw Expert
Noch festgefahren?
Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.