¿Recibiste un error 429 al usar la API de OPenClaw? No te preocupes, es un problema común de límite de velocidad (Rate Limit). Esta guía te ayuda a identificar rápidamente las causas, gestionar tu cuota de manera eficiente y evitar interrupciones en tu desarrollo.
¿Qué es un error de límite de velocidad?
Cuando envías demasiadas solicitudes al servidor de OPenClaw en un corto período de tiempo, la API devuelve el error HTTP 429 Too Many Requests. Esto protege los recursos del backend para evitar que un solo usuario consuma demasiado ancho de banda. Los usuarios de la versión gratuita suelen tener un límite más estricto de solicitudes por minuto, mientras que los planes profesionales ofrecen cuotas más flexibles. Una vez que se activa la limitación, las solicitudes se bloquean temporalmente hasta que se reinicie la ventana.
Causas comunes
La situación más frecuente es que el código ejecute solicitudes en un bucle sin agregar retardos. Por ejemplo, al procesar datos por lotes se envían peticiones continuas, alcanzando el límite en cuestión de segundos. Además, varias aplicaciones que comparten la misma clave de API acumulan solicitudes, agotando la cuota rápidamente. La versión gratuita de OPenClaw suele limitar entre 20 y 30 solicitudes por minuto, superarlas dispara el error 429.
Otro caso común son los reintentos frecuentes tras la invalidación de caché. Por ejemplo, cuando hay fluctuaciones de red se reintentan tres veces automáticamente; si cada reintento sigue de inmediato a la solicitud original, es fácil exceder el umbral. También, algunas bibliotecas de terceros habilitan solicitudes concurrentes por defecto, consumiendo la cuota sin que te des cuenta.
