Verificaciones de Salud (CLI)

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

- openclaw status — resumen local: alcanzabilidad/modo del gateway, pista de actualización, antigüedad de auth del canal vinculado, sesiones + actividad reciente.

- openclaw status --all — diagnóstico local completo (solo lectura, color, seguro para pegar para depuración).

- openclaw status --deep — también sondea el Gateway en ejecución (sondeos por canal cuando es soportado).

- openclaw health --json — solicita al Gateway en ejecución un snapshot completo de salud (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: usa tail /tmp/openclaw/openclaw-*.log y filtra por web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

- Credenciales en disco: <code>ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json</code> (mtime debe ser reciente).

- Almacén de sesiones: <code>ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json</code> (la ruta puede sobrescribirse en configuración). El conteo y destinatarios recientes se muestran vía <code>status</code>.

- Flujo de re-vinculación: openclaw channels logout && openclaw channels login --verbose cuando códigos de estado 409–515 o loggedOut aparecen en logs. (Nota: el flujo de login QR se reinicia automáticamente una vez para estado 515 después del emparejamiento.)

- logged out o estado 409–515 → re-vincular con openclaw channels logout luego openclaw channels login.

- Gateway inalcanzable → iniciarlo: 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 que lista permitida + reglas de mención coincidan (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

<code>openclaw health --json</code> solicita al Gateway en ejecución su snapshot de salud (sin sockets de canal directos desde el CLI). Reporta credenciales vinculadas/antigüedad de auth cuando está disponible, resúmenes de sondeo por canal, resumen del almacén de sesiones, y duración del sondeo. Termina con código no cero si el Gateway es inalcanzable o el sondeo falla/timeout. Usa <code>--timeout <ms>'</code> para sobrescribir el predeterminado de 10s.