Verificaciones de salud (CLI)

Guía breve para verificar la conectividad de canales sin adivinar.

Verificaciones rápidas

openclaw status — resumen local: accesibilidad/modo del gateway, indicación de actualización, antigüedad de autenticación de canales vinculados, sesiones + actividad reciente.
openclaw status --all — diagnóstico local completo (solo lectura, con color, seguro de pegar para depuración).
openclaw status --deep — también prueba el Gateway en ejecución (pruebas por canal cuando están soportadas).
openclaw health --json — consulta al Gateway en ejecución para una instantánea de salud completa (solo WS; sin socket Baileys directo).
Envía /status como mensaje independiente en WhatsApp/WebChat para obtener una respuesta de estado sin invocar al agente.
Logs: haz tail de /tmp/openclaw/openclaw-*.log y filtra por web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

Diagnósticos profundos

Credenciales en disco: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (mtime debería ser reciente).
Almacén de sesiones: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (la ruta puede ser sobrescrita en la configuración). El conteo y destinatarios recientes se muestran vía status.
Flujo de re-vinculación: openclaw channels logout && openclaw channels login --verbose cuando aparecen códigos de estado 409–515 o loggedOut en los logs. (Nota: el flujo de login QR se auto-reinicia una vez para estado 515 después del emparejamiento.)

Cuando algo falla

logged out o estado 409–515 → re-vincula con openclaw channels logout luego openclaw channels login.
Gateway inaccesible → inícialo: openclaw gateway --port 18789 (usa --force si el puerto está ocupado).
Sin mensajes entrantes → confirma que el teléfono vinculado está en línea y el remitente está permitido (channels.whatsapp.allowFrom); para chats grupales, asegúrate de que las reglas de lista de permitidos + mención coincidan (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

Comando “health” dedicado

openclaw health --json consulta al Gateway en ejecución para su instantánea de salud (sin sockets de canal directos desde el CLI). Reporta credenciales vinculadas/antigüedad de autenticación cuando están disponibles, resúmenes de pruebas por canal, resumen del almacén de sesiones y una duración de prueba. Sale con código no cero si el Gateway es inaccesible o la prueba falla/expira. Usa --timeout <ms> para sobrescribir el valor por defecto de 10s.