Cómo gestionar la presencia en OpenClaw

Gestionar sistemas distribuidos suele ser un caos cuando no sabes qué procesos están activos en cada momento. Es frustrante intentar depurar una conexión y no tener visibilidad clara sobre quién está conectado o si un nodo se ha quedado colgado sin avisar.

OpenClaw soluciona esto con un sistema de presencia ligero. Te permite ver el estado del Gateway y de los clients conectados (como la mac app, WebChat o la CLI) sin complicar la infraestructura. Es la mejor forma de mantener el control operativo de tus instancias.

Requisitos previos

• OpenClaw Gateway en ejecución.
• Al menos un cliente conectado (macOS app, WebChat, CLI o un Node.js).

Inicio rápido

Sigue estos pasos para ver tus instancias activas en menos de 5 minutos:

1. Inicia el Gateway: Al arrancar, el Gateway genera automáticamente una entrada self. Esto garantiza que siempre veas el host del Gateway en la lista, incluso antes de que se conecten otros clientes.
2. Conecta un cliente: Cuando un cliente inicia un handshake vía WebSocket, el Gateway registra su presencia.
3. Envía datos detallados: Si usas la macOS app, esta enviará beacons periódicos mediante el método system-event para reportar el nombre del host, la IP y el lastInputSeconds.
4. Consulta el estado: Abre la pestaña Instances en la aplicación de macOS para ver la lista visual, o llama directamente a system-presence para obtener los datos en formato JSON.

Solución de problemas

Si encuentras comportamientos inesperados, revisa estos puntos basados en la lógica interna del sistema:

• Instancias duplicadas: Esto ocurre si los clientes se reconectan sin un instanceId estable. Asegúrate de que tus clientes envíen un connect.client.instanceId consistente que sobreviva a los reinicios.
• La CLI no aparece: Es el comportamiento esperado. Para evitar saturar la lista con comandos efímeros, el modo client.mode === "cli" no genera una entrada de presencia.
• IPs incorrectas (127.0.0.1): Si conectas a través de un túnel SSH o port forward, el Gateway ignorará las direcciones de loopback para no sobrescribir una IP válida reportada por el cliente.
• Entradas que desaparecen: La presencia es efímera. Las entradas se eliminan si tienen más de 5 minutos de antigüedad (TTL) o si se supera el límite de 200 registros.

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

Próximos pasos

• Configuración del Gateway
• Uso de la CLI
• Eventos de sistema
• Guía de la macOS App