Zum Inhalt springen

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.

Verstehe und behebe Probleme beim Model Failover.


Failover läuft in zwei Phasen ab:

  1. Auth profile rotation innerhalb desselben Providers.
  2. 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”“
  1. Prüfe den Speicherort der Auth-Profile:

    • Aktuell: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
    • Legacy: ~/.openclaw/agent/* (wird durch openclaw doctor migriert)
  2. Bestätige, dass deine Umgebungsvariablen vom Gateway geladen werden:

    • Falls du ANTHROPIC_API_KEY in deiner Shell setzt, das Gateway aber via systemd/launchd ausführst, wird die Variable eventuell nicht übernommen.
    • Hinterlege sie in ~/.openclaw/.env oder aktiviere env.shellEnv.
  3. Stelle sicher, dass du den richtigen Agent bearbeitest:

    • Bei Multi-Agent-Setups können mehrere auth-profiles.json Dateien existieren.
  4. Ü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:

Terminal-Fenster
claude setup-token
openclaw models auth setup-token --provider anthropic

Falls du stattdessen einen API-Key nutzen willst:

  • Hinterlege ANTHROPIC_API_KEY in ~/.openclaw/.env auf 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.

AI Setup Assistant

OpenClaw

OpenClaw Expert

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.