Por qué aparece "Rate limited — switching to fallback provider" y cómo solucionarlo definitivamente
No es un fallo del sistema: Hermes cambia automáticamente al proveedor de respaldo cuando el principal alcanza su límite de peticiones (rate limit). La causa más probable es que el proveedor principal y el de respaldo compartan el mismo pool de cuota o gateway saturado, por lo que el cambio no soluciona realmente la...
⚠️ Rate limited — switching to fallback providerAI-generated editorial hero image for ⚠️ Rate limited — switching to fallback provider... 🔄 Primary model failed — switching to fallback: sg claude opus 4.7 via custom Sao cứ bị.
Prompt de IA
Create a landscape editorial hero image for this Studio Global article: ⚠️ Rate limited — switching to fallback provider... 🔄 Primary model failed — switching to fallback: sg claude opus 4.7 via custom Sao cứ bị. Article summary: Đây không hẳn là “bug fallback”, mà là model chính của Sếp đang bị rate limit nên Hermes tự nhảy sang fallback sg claude opus 4.7 via custom đúng như thiết kế.[8] Vì fallback của Hermes là per turn, nên mỗi tin nhắn mới . Topic tags: general web, openai, llm, ai, workflow. Reference image context from search candidates: Reference image 1: visual subject "# Fallback Providers. ## Primary Model Fallback. When your main LLM provider encounters errors — rate limits, server overload, auth failures, connection drops — Hermes can automat" source context "Fallback Providers | Hermes Agent - nous research" Reference image 2: visual subject "March 18, 2026 - (rate_limit
openai.com
Si estás viendo repetidamente el mensaje "⚠️ Rate limited — switching to fallback provider... 🔄 Primary model failed — switching to fallback: sg claude opus 4.7 via custom", no te preocupes: no es un error de software, sino el comportamiento esperado de Hermes ante límites de uso del proveedor principal.
Como el mecanismo de respaldo (fallback) se activa por turno, cada nueva interacción intenta primero conectar con el modelo primario. Si éste sigue bloqueado, Hermes vuelve a mostrar el aviso y salta al secundario. De ahí la sensación de que el error "nunca termina".
¿Qué significa exactamente el mensaje?
Hermes está diseñado para cambiar automáticamente a un modelo de respaldo cuando el principal falla por límites de tasa, errores de servidor, autenticación rechazada, conexiones caídas, errores HTTP 404 o respuestas dañadas.
Al activar el respaldo, la conversación se mantiene íntegra (no pierdes el contexto). El problema es que, al ser un mecanismo por turno, Hermes reintenta el modelo original en cada nuevo mensaje. Si el límite de tasa sigue vigente, el ciclo se repetirá una y otra vez.
Por qué se repite sin cesar
La causa directa es que el modelo principal sigue experimentando restricciones de tasa en el proveedor (upstream). Cada nuevo turno fracasa y el sistema recurre de nuevo al fallback
sg-claude-opus-4.7 via custom
.
Si el error concreto es un HTTP 429, los propios documentos de OpenClaw indican que puede deberse a varias situaciones:
Cuota de peticiones agotada en el proveedor.
Restricciones específicas por tokens de contexto largo ("Extra usage is required for long context requests").
Límites de organización dentro del proveedor.
Además, si el mensaje muestra
sg-claude-opus-4.7 via custom
, la conmutación está usando un endpoint personalizado configurado en Hermes, no un cambio radical a otro proveedor nativo.
El punto clave en este caso concreto
El texto
sg-claude-opus-4.7 via custom
revela que el respaldo está pasando por un endpoint a medida guardado en config.yaml, no por un proveedor completamente distinto. Si tanto el primario como el
sg-claude-opus-4.7 via custom
dependen del mismo pool saturado de cuota o del mismo gateway intermedio, el cambio será solo aparente y el mensaje seguirá apareciendo.
No tenemos evidencia absoluta de que ambos compartan infraestructura, pero es la hipótesis más plausible. Hermes guarda los endpoints personalizados y las cadenas de fallback en el archivo de configuración, así que merece la pena revisarlos directamente.
Pasos para una solución definitiva
Revisa el archivo config.yaml y localiza las claves fallback_providers, provider y model asignadas al respaldo sg-*.
Comprueba si el primario y el custom comparten gateway, pool de cuota o clave de API. Si es así, el fallback no te sacará del problema.
Ejecuta un diagnóstico real del gateway con
openclaw gateway probe
para confirmar si el error es 429, de autenticación o de desajuste cliente/gateway.
Asegúrate de que la clave API esté bien ubicada. Si el gateway la lee desde variables de entorno, comprueba que esté en el host correcto y reinicia el servicio tras cambiarla.
Si trabajas con contextos muy largos, revisa las restricciones específicas para peticiones de contexto amplio. OpenClaw advierte que los 429 pueden activarse por necesitar "uso extra" en estas peticiones.
Conclusión
El mensaje se repite porque Hermes está haciendo exactamente lo que debe: reintentar el primario en cada turno mientras exista limitación de tasa. Para eliminarlo, has de resolver el bloqueo en origen (proveedor principal, gateway intermedio o pool de cuota compartido), no limitarte a ver la alerta de "cambio a fallback".
Si quieres, puedo ayudarte a leer el archivo de configuración real y señalar con precisión qué modelo primario está fallando, adónde apunta exactamente el fallback sg-* y por qué Hermes insiste en volver a él cada turno.
Studio Global AI
Search, cite, and publish your own answer
Use this topic as a starting point for a fresh source-backed answer, then compare citations before you share it.
¿Cuál es la respuesta corta a "Por qué aparece "Rate limited — switching to fallback provider" y cómo solucionarlo definitivamente"?
No es un fallo del sistema: Hermes cambia automáticamente al proveedor de respaldo cuando el principal alcanza su límite de peticiones (rate limit).
¿Cuáles son los puntos clave a validar primero?
No es un fallo del sistema: Hermes cambia automáticamente al proveedor de respaldo cuando el principal alcanza su límite de peticiones (rate limit). La causa más probable es que el proveedor principal y el de respaldo compartan el mismo pool de cuota o gateway saturado, por lo que el cambio no soluciona realmente la limitación.
¿Qué debo hacer a continuación en la práctica?
Para una solución definitiva hay que atacar la raíz: comprobar si el error real es un HTTP 429 por peticiones de contexto largo, rotar claves API, sondear el estado del gateway con openclaw gateway probe y garantizar...
