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

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.