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

Der kritische Punkt: „via custom"

Der Zusatz

via custom

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.