Hermes-Fallback-Schleife: Warum die Fehlermeldung immer wieder auftaucht und wie Sie sie beheben

Genau dieses Verhalten erzeugt den Eindruck einer Dauerbaustelle. Solange das primäre Modell nicht wieder erreichbar ist, sehen Sie bei jeder Nachricht dieselbe Warnung.

Warum die Meldung ständig wiederkehrt

Die unmittelbare Ursache liegt beim Upstream-Anbieter: Ihr primäres Modell ist und bleibt ratenbegrenzt (Rate-Limited). Jeder neue Versuch scheitert, und Hermes schwenkt pflichtbewusst auf sg-claude-opus-4.7 via custom um.

Liegt tatsächlich ein HTTP-429-Fehler vor, stufen auch die OpenClaw-Dokumentationen dies als Rate-Limit- oder Upstream-Begrenzungsproblem ein, das auf Gateway-Ebene untersucht werden muss. Bei 429-Fehlern spielt oft auch die Kontextlänge eine Rolle: Besonders lange Prompts oder sehr umfangreiche Konversationen können vom Upstream-Anbieter strengeren Quoten unterworfen werden.

Der kritische Punkt: „via custom"

Der Zusatz via custom in der Fehlermeldung ist ein wichtiger Hinweis. Er zeigt, dass der Fallback über einen benutzerdefinierten Endpunkt läuft, den Sie oder Ihr Administrator in der Hermes-Konfiguration hinterlegt haben – und nicht über einen nativen Standardanbieter.

Das birgt ein Risiko: Wenn Primary und Fallback auf dieselbe Backend-Infrastruktur, denselben Gateway oder denselben API-Key-Pool zurückgreifen, nützt der Wechsel wenig. Sie sehen dann zwar einen anderen Provider-Namen, aber das eigentliche Quotenproblem bleibt bestehen. Die verfügbaren Quellen liefern keinen zwingenden Beweis für diese Konstellation, aber die Wahrscheinlichkeit ist hoch und sollte in der tatsächlichen Konfiguration überprüft werden.

Laut Hermes-Dokumentation werden benutzerdefinierte Endpunkte in der config.yaml gespeichert, ebenso wie die Fallback-Kette unter dem Schlüssel fallback_providers.

Schritt-für-Schritt zur Lösung

Bevor Sie irgendetwas ändern, sollten Sie zunächst die genaue Konfiguration prüfen:

1. Die Konfigurationsdatei einsehen: Öffnen Sie ~/.hermes/config.yaml und identifizieren Sie das primäre Modell sowie die Fallback-Kette. Welcher provider und welches model sind jeweils eingetragen?

2. Gemeinsame Infrastruktur ausschließen: Nutzen Primary und der benutzerdefinierte Fallback („sg-claude-opus-4.7 via custom“) möglicherweise denselben Gateway, denselben API-Key oder denselben Backend-Pool? Falls ja, ist der Fallback wirkungslos – Sie müssen einen wirklich unabhängigen Ersatzanbieter konfigurieren.

3. Gateway-Status prüfen: Falls Sie OpenClaw als Gateway einsetzen, führen Sie openclaw gateway probe aus. Der Befehl zeigt, ob der Gateway erreichbar ist und welche Authentifizierungsebene nachgewiesen werden kann. So erkennen Sie, ob der Fehler wirklich ein 429 ist oder vielleicht ein Authentifizierungsproblem vorliegt.

4. API-Keys und Umgebungsvariablen kontrollieren: Wenn der Gateway oder Dienst seine Zugangsdaten aus Umgebungsvariablen (~/.openclaw/.env) bezieht, stellen Sie sicher, dass die Datei auf dem Host-Rechner des Gateways korrekt gepflegt ist. Nach jeder Änderung muss der Gateway-Dienst neu gestartet werden.

5. Lange Kontexte als Sonderfall: Tritt das Problem vor allem bei sehr langen Gesprächsverläufen auf, sollten Sie die Einstellungen für „long context requests“ prüfen. Die OpenClaw-Dokumentation weist ausdrücklich darauf hin, dass 429-Fehler durch zusätzliche Kontingent-Anforderungen für lange Kontexte entstehen können.

Fazit

Die sich wiederholende Warnung ist kein Konfigurationsfehler und kein Bug, sondern das korrekte Verhalten des Per-Turn-Fallbacks von Hermes. Um sie dauerhaft loszuwerden, müssen Sie die Ursache im primären Anbieter beheben – sei es durch Erhöhung des Kontingents, durch Entzerrung von Primary- und Fallback-Infrastruktur oder durch Anpassung der Kontextlängen. Solange das Problem nur bei der Fehlermeldung selbst gesucht wird, wird sich nichts ändern.