Al usar OPenClaw, encontrarse con códigos de error puede ser frustrante. Ya sea una llamada a la API fallida o un tiempo de espera agotado, localizar el problema rápidamente es clave para retomar el trabajo. Este artículo recopila los errores más comunes de OPenClaw y los pasos manuales para solucionarlos, ayudándote a ahorrar tiempo.
Clave de API inválida o caducada
El código de error 401 generalmente indica que la clave es incorrecta o ha expirado. Primero, inicia sesión en el panel de OPenClaw y revisa el estado de tu clave en la sección "API Keys". Si aparece en rojo como "Expired", genera una nueva clave y reemplázala en tu código. Ten cuidado al copiar: evita espacios adicionales, un detalle común en el que muchos principiantes tropiezan.
Si la clave es válida pero aún recibes un error 403, es posible que los permisos no estén configurados correctamente. Asegúrate de que la clave tenga los permisos de acceso a los modelos que necesitas, como "claw-4" o "claw-vision". Guarda los cambios y espera 1 minuto antes de volver a intentarlo; la sincronización de permisos de OPenClaw a veces se retrasa.
Límite de velocidad (error 429)
Enviar demasiadas solicitudes en poco tiempo activa el límite de velocidad, con el código de error 429. La versión gratuita de OPenClaw permite hasta 30 solicitudes por minuto, mientras que las versiones de pago varían entre 60 y 200 según el plan. La solución es simple: añade retardos en tu código. Por ejemplo, en Python usa time.sleep(2) para espaciar cada solicitud al menos 2 segundos. Si estás procesando en lote, se recomienda usar un algoritmo de retroceso exponencial.
También verifica si tienes varios scripts ejecutándose al mismo tiempo. En el panel de control, la sección "Usage" muestra la tasa de solicitudes en tiempo real. Si supera la línea roja, detente y espera unos minutos. Vuelve a intentarlo con calma, no insistas a la fuerza.
