Al integrar la API de OpenClaw, muchos desarrolladores se topan con errores. Este artículo recopila los códigos de error más comunes y sus soluciones para que puedas identificar el problema rápido y evitar contratiempos.
Error de autenticación: 401 Unauthorized
La causa más frecuente del error 401 es una clave de API inválida o expirada. Revisa tu consola de OpenClaw, asegúrate de que la clave esté en estado "Active" y verifica que el campo Authorization en los encabezados tenga el formato correcto, por ejemplo Bearer your_api_key. Si acabas de generar la clave, espera unos minutos o vuelve a copiarla sin espacios extra.
Tiempo de espera agotado: 408 Request Timeout
Si los timeouts son frecuentes, normalmente se debe a la red o a la carga del servidor. Prueba la conectividad local al endpoint de la API de OpenClaw con curl. Si la red funciona, reduce el valor del parámetro max_tokens por solicitud o cambia a un plan con mayor cuota de concurrencia. Además, evita enviar muchas solicitudes cortas en horas pico e implementa un mecanismo de reintento con backoff exponencial.
