Health Checks en macOS

¿Alguna vez has pensado que tu integración funciona perfectamente, solo para descubrir que la conexión se cayó hace horas? Monitorear estados de conexión de forma manual es tedioso y quita tiempo que podrías usar programando. No hay nada peor que darte cuenta de un fallo cuando ya es demasiado tarde.

Para evitar esto, lo mejor es tener visibilidad constante sin tener que abrir la terminal cada cinco minutos. Aquí te explico cómo usar las herramientas de monitoreo en macOS.

Requisitos previos

• App de la barra de menú para macOS.
• Un canal vinculado (Baileys, WhatsApp o Telegram).

Inicio rápido

Configurar el monitoreo te tomará menos de 5 minutos. Sigue estos pasos para asegurar que todo esté en orden:

1. Observa la barra de menú: El punto de estado refleja la salud de Baileys. Si está en verde, estás vinculado y el socket abrió recientemente. Si lo ves en naranja, el sistema está conectando o reintentando. El rojo indica que cerraste sesión o que el probe falló.
2. Usa el acceso directo: Haz clic en el ítem “Run Health Check” del menú para disparar una verificación inmediata.
3. Revisa los detalles en Settings: Entra a la pestaña General para ver el Health card. Ahí encontrarás el tiempo de autenticación (auth age) y la ruta del session-store.
4. Gestiona tus canales: En la pestaña Channels, verás el estado específico de WhatsApp o Telegram, junto con botones para login QR, logout y el último error registrado.

How the probe works

La app ejecuta el comando openclaw health --json mediante un ShellExecutor aproximadamente cada 60 segundos. Este probe carga las credenciales e informa el estado sin necesidad de enviar mensajes. Para evitar parpadeos visuales en la interfaz, el sistema guarda por separado el último snapshot exitoso y el último error, mostrando la marca de tiempo de cada uno.

Solución de problemas

Si encuentras problemas con el estado de tus canales, puedes usar estas soluciones basadas en los logs del sistema:

• El punto de estado no cambia: El sistema usa un snapshot en caché para que la UI cargue al instante. Verifica la hora de la última comprobación en la pestaña General.
• Fallos de conexión persistentes: Si el punto está en rojo, revisa el motivo del fallo en la línea secundaria del menú (ej. “auth 12m” o el motivo específico de falla).
• Necesitas un diagnóstico profundo: Si la interfaz no es suficiente, ejecuta openclaw status --deep o openclaw health --json en tu terminal.
• Errores de heartbeat: Puedes seguir los logs en tiempo real revisando el archivo /tmp/openclaw/openclaw-*.log para buscar eventos de web-heartbeat o web-reconnect.

Para resolver dudas específicas sobre tu configuración, consulta al AI Setup Assistant.

Próximos pasos

• Gateway health