Solución de Problemas

¿Tienes problemas con tu ClawBox? Esta guía cubre los problemas comunes y sus soluciones.

Diagnóstico Rápido

Terminal
# SSH into your ClawBox (user: clawbox, password: clawbox)
# Check system status
ssh clawbox@clawbox.local 'openclaw status'

# View recent logs
ssh clawbox@clawbox.local 'openclaw logs --tail 50'

# Check service health
ssh clawbox@clawbox.local 'openclaw health'

# Test network connectivity
ping clawbox.local

Problemas Comunes

🔴

ClawBox No Arranca

critical

Síntomas:

  • •Sin luces ni actividad
  • •El LED de estado permanece apagado
  • •Sin respuesta al botón de encendido

Soluciones:

  1. 1Verifica que el adaptador de corriente esté conectado firmemente
  2. 2Prueba con una toma de corriente diferente
  3. 3Comprueba si el LED de encendido del adaptador está encendido
  4. 4Contacta a soporte si el problema persiste
🌐

Sin Conexión de Red

high

Síntomas:

  • •No puedo acceder a clawbox.local
  • •Los mensajes no se envían
  • •El estado muestra sin conexión

Soluciones:

  1. 1Verifica la conexión del cable Ethernet (intenta reconectarlo)
  2. 2Comprueba que tu router tenga direcciones DHCP disponibles
  3. 3Intenta conectarte por Wi-Fi en su lugar
  4. 4Verifica si otros dispositivos pueden acceder a la red
🐢

Respuestas de IA Lentas

medium

Síntomas:

  • •Largos retrasos antes de las respuestas
  • •Tiempos de espera en consultas complejas
  • •El sistema se siente lento

Soluciones:

  1. 1Asegura una ventilación adecuada (evita espacios cerrados)
  2. 2Verifica si otros procesos están ejecutándose (comando top)
  3. 3Reinicia el servicio de IA: openclaw restart
  4. 4Considera usar un modelo de IA más pequeño para respuestas más rápidas
💬

Los Mensajes No Se Reciben

medium

Síntomas:

  • •El bot aparece en línea pero no responde
  • •Los mensajes se muestran como enviados pero sin respuesta
  • •Funciona en algunas plataformas pero no en otras

Soluciones:

  1. 1Verifica que la plataforma esté correctamente vinculada (revisa la configuración)
  2. 2Reinicia el servicio de mensajería: openclaw restart messaging
  3. 3Vuelve a autorizar el bot en la plataforma afectada
  4. 4Revisa las URLs de webhook en la configuración de desarrollador de la plataforma
🌡️

Sobrecalentamiento

high

Síntomas:

  • •El ventilador funciona a máxima velocidad constantemente
  • •Advertencias de limitación térmica en los registros
  • •El dispositivo se siente caliente al tacto

Soluciones:

  1. 1Muévelo a un área bien ventilada
  2. 2Limpia el polvo de las rejillas y el ventilador
  3. 3Reduce la temperatura ambiente
  4. 4Verifica que no haya obstrucciones del flujo de aire alrededor del dispositivo

Consultando Registros

Los registros son esenciales para diagnosticar problemas. Usa estos comandos para acceder a diferentes tipos de registros.

Terminal
# View all logs
openclaw logs

# View specific service logs
openclaw logs --service chat
openclaw logs --service browser
openclaw logs --service voice

# Follow logs in real-time
openclaw logs -f

# Filter by log level
openclaw logs --level error

# Export logs for support
openclaw logs --export support-bundle.zip

Opciones de Reinicio

⚠️

Advertencia

Algunas opciones de reinicio borrarán tus datos. Siempre haz una copia de seguridad de las configuraciones importantes primero.

Tipos de Reinicio

openclaw reset --softReinicia los servicios sin perder datos
openclaw reset --hardLimpia la caché y reinicia todos los servicios
openclaw reset --factoryBorra todos los datos y restaura a los valores de fábrica
# Soft reset (restart services)
openclaw reset --soft

# Hard reset (clear cache, restart)
openclaw reset --hard

# Factory reset (WARNING: erases all data)
openclaw reset --factory --confirm

Indicadores de Estado LED

Verde Fijo

El sistema está funcionando normalmente

Verde Parpadeante

Procesando una solicitud o arrancando

Naranja Fijo

El sistema está iniciando o actualizándose

Naranja Parpadeante

Estado de advertencia — revisa los registros para más detalles

Rojo Fijo

Estado de error — se requiere intervención

Obtener Soporte

Si no puedes resolver el problema, nuestro equipo de soporte está listo para ayudarte.

Antes de Contactar a Soporte:

  • □Anota el mensaje de error exacto o el comportamiento
  • □Verifica el indicador de estado LED
  • □Prueba los pasos de solución de problemas relevantes anteriores
  • □Exporta los registros: openclaw logs --export

Incluye en Tu Solicitud:

  • ✓Número de serie del ClawBox (en la etiqueta inferior)
  • ✓Descripción del problema
  • ✓Pasos para reproducirlo
  • ✓Archivo de exportación de registros (si está disponible)
🤖Soporte en Telegram💬Comunidad en Discord✉️Soporte por Correo Electrónico