Waarom zie ik steeds '⚠️ Rate limited — switching to fallback provider?'

Waarom blijft de melding terugkomen?

De crux zit in hoe Hermes het fallback-systeem toepast. Het is niet zo dat Hermes voor de rest van je sessie overschakelt op het reservemodel. Bij elk nieuw bericht dat je stuurt, probeert Hermes eerst opnieuw verbinding te maken met het primaire model. Alleen als dat opnieuw mislukt, wordt de fallback weer geactiveerd.

Zolang de overbelasting van je primaire model aanhoudt, zul je dus bij elk nieuw bericht deze cyclus zien: een mislukte poging naar je hoofdmodel, gevolgd door de switch naar sg-claude-opus-4.7. Het is een herhalend symptoom van een probleem dat nog niet is opgelost.

De echte oorzaak vinden

Om dit te stoppen, moet je de bron van de overbelasting aanpakken. De melding vertelt je dát er een probleem is, maar niet altijd precies waarom. Hier zijn de meest logische stappen om te doorzoeken:

1. Check je configuratiebestand: In je ~/.hermes/config.yaml bestand vind je alle details. Kijk daar onder providers naar je primaire model en onder fallback_providers naar de fallback-chain. Noteer welke 'provider' en 'model' daar staan.
2. Deel je primaire en fallback-model dezelfde infrastructuur? Als je primaire model en je fallback sg-claude-opus-4.7 via custom uiteindelijk via dezelfde server, gateway, of hetzelfde API-key-pool lopen, dan schiet je er niets mee op. De overbelasting treft dan beide modellen, waardoor de switch zinloos is en het probleem hardnekkig aanvoelt. Dit is een veelvoorkomende valkuil.
3. Let op lange gesprekken: Soms ontstaat een 'rate limit' specifiek door de lengte van je prompt of de context van een lang gesprek. Sommige services hanteren strengere quota voor deze 'long context requests'. Als de foutmelding de exacte tekst HTTP 429: rate_limit_error: Extra usage is required for long context requests bevat, is dit bijna zeker de oorzaak.

Hoe los je het op?

• Herstart je gateway: Als je via een OpenClaw-gateway werkt en de API-sleutels zijn via omgevingsvariabelen ingesteld, kan het helpen de gateway-service te herstarten nadat je een configuratiewijziging hebt doorgevoerd.
• Voer een diagnose uit: Gebruik de commandoregel om de status van je verbinding te testen. Met openclaw gateway probe kun je controleren of de verbinding met je provider succesvol is en of er niet een ander, dieperliggend authenticatieprobleem speelt.
• Breid je vangnet uit: Als je merkt dat je primaire model vaak overbelast is, overweeg dan om je fallback-chain uit te breiden met een model van een compleet andere provider. Dit verkleint de kans dat beide modellen tegelijkertijd onbereikbaar zijn.

Het is een kwestie van de juiste diagnose stellen. De foutmelding is een signaal, niet het probleem zelf. Door je configuratie na te lopen en te zorgen voor een echt onafhankelijk vangnet, maak je een einde aan die eindeloze stroom waarschuwingen.

Zelf aan de slag: Open je config.yaml bestand en controleer de provider en modelnamen onder je fallback_providers lijst. Zorg dat deze verwijst naar een service die losstaat van je hoofdmodel, en de kans is groot dat de melding verdwijnt.