¿Tienes problemas de conexión o tiempos de espera al usar OpenClaw? Esta guía recopila los códigos de error más frecuentes de OpenClaw y sus soluciones para que puedas restaurar el servicio rápidamente. Ya sea un error devuelto por la API o un fallo del cliente, sigue los pasos indicados para resolverlo.
Errores relacionados con autenticación y permisos
El código 401 o 403 suele indicar que la clave no es válida o que no tienes permisos suficientes. Primero verifica que la API Key esté copiada correctamente, asegurándote de incluir todos los caracteres sin espacios adicionales. Si la clave sigue dentro del período de validez, intenta regenerarla en el panel de OpenClaw y actualízala en el archivo de configuración.
Algunos usuarios se encuentran con el mensaje «Rate Limit Exceeded», lo que significa que la frecuencia de solicitudes supera el límite de la versión gratuita. La solución es reducir el intervalo de llamadas o aumentar la cuota en la versión de pago. Puedes consultar el uso actual desde la consola oficial y planificar el ritmo de las solicitudes de forma razonable.
Problemas de conexión y red
Los códigos 500 o 503 indican una falla temporal del servidor. Se recomienda esperar 5 minutos y reintentar, mientras verificas que tu red local pueda acceder al sitio web oficial de OpenClaw. Si aparece con frecuencia «Connection Timeout», prueba cambiando el DNS o usando un nodo proxy.
Para el error «SSL Handshake Failed», actualiza los certificados raíz del sistema o desactiva el bloqueo del firewall. En Windows, ejecuta «certmgr.msc» para importar los certificados más recientes; en Mac, repara desde el Llavero. No modifiques las reglas de verificación SSL sin cuidado, ya que podrías reducir la seguridad.
