¿Qué hacer cuando OpenClaw muestra versión de Node.js incompatible?

OpenClaw requiere Node.js 22 o superior. Ejecuta nvm install 22 && nvm use 22 para actualizar la versión de Node.js.

¿Cómo solucionar 'auth not configured' en openclaw health?

Ejecuta openclaw onboard para reconfigurar la autenticación. Si usas setup-token, asegúrate de ejecutar claude setup-token para generar un nuevo token.

¿Qué hacer cuando falla el escaneo del código QR de WhatsApp?

Primero ejecuta openclaw channels logout whatsapp para cerrar sesión, luego ejecuta openclaw channels login whatsapp para iniciar sesión nuevamente y escanear un nuevo código QR.

¿Cómo solucionar que el bot de Telegram no responde a los mensajes?

Primero necesitas aprobar el código de emparejamiento. Ejecuta openclaw pairing list telegram para ver emparejamientos pendientes, luego ejecuta openclaw pairing approve telegram [CODE] para aprobar.

¿Cómo ver los logs de OpenClaw para diagnosticar problemas?

Ejecuta openclaw logs --follow para ver logs en tiempo real, o usa openclaw gateway en primer plano para ver la salida completa. Los archivos de log se almacenan en el directorio ~/.openclaw/logs/.

¿Cómo restablecer toda la configuración de OpenClaw?

Haz una copia de seguridad, luego elimina el directorio ~/.openclaw y vuelve a ejecutar openclaw onboard para la configuración inicial. Nota: Esto eliminará toda la información de autenticación y el historial de chat.

¿Qué hacer cuando el puerto 18789 del gateway de OpenClaw está ocupado?

Ejecuta lsof -i :18789 para verificar qué proceso está usando el puerto, usa openclaw gateway --port 18790 para especificar otro puerto, o modifica el puerto predeterminado en el archivo de configuración.

¿Cómo verificar la versión actual de OpenClaw?

Ejecuta openclaw --version para verificar la versión instalada actualmente, ejecuta openclaw status --all para obtener un informe completo del estado del sistema.

Solución de Problemas

Solución de Problemas OpenClaw

¿Tienes problemas? Encuentra diagnóstico rápido y soluciones para problemas comunes aquí

Diagnóstico Rápido

Usa estos comandos para diagnosticar problemas rápidamente

openclaw status --all

Mejor reporte de diagnóstico con un clic con toda la información de estado

openclaw gateway status

Verificar estado del daemon y conectividad RPC

openclaw doctor

Reparar automáticamente problemas comunes de configuración

Se recomienda ejecutar openclaw status --all primero para obtener un reporte de diagnóstico completo, luego localizar el problema según la salida.

Problemas de Inicio e Instalación

Resolver fallos de inicio de OpenClaw, dependencias faltantes y más

Problemas de Autenticación y Modelo

Resolver problemas de OAuth, Clave API, acceso a modelos y otros de autenticación

Problemas de Conexión de Canal

Resolver fallos de conexión de WhatsApp, Telegram, Discord y otros canales

Problemas de Mensaje y Sesión

Resolver tiempo de espera de sesión, variables de entorno y otros problemas de configuración

Depuración y Logs

Aprende cómo ver logs, generar reportes de depuración y obtener ayuda

Ver Logs

Ver información detallada de tiempo de ejecución y errores a través de logs

Ver logs en tiempo real

$ openclaw logs --follow

Iniciar en primer plano para ver salida completa

$ openclaw gateway

Generar Reporte de Depuración

Generar un reporte de depuración completo para ayudar a solucionar problemas o buscar asistencia

$ openclaw status --all

El reporte de depuración contiene estado del sistema, información de configuración, y es la información más útil al buscar ayuda.

Obtener Ayuda

Si los métodos anteriores no pueden resolver tu problema, puedes obtener ayuda a través de estos canales

Documentación de Preguntas Frecuentes Oficial GitHub Discussions (Hacer preguntas) Comunidad de Discord

¿Problema Resuelto?

Si tu problema está resuelto, puedes continuar explorando otras características de OpenClaw.