Nodes and media
Presencia activa en el equipo
La presencia activa del equipo indica al Gateway qué nodo macOS conectado recibió
la entrada física de ratón o teclado más reciente. OpenClaw utiliza esa señal para
marcar un Mac como active, proporcionar al agente una indicación estable del nodo activo y dirigir
las alertas de conexión de nodos al equipo en el que es más probable que se encuentre presente.
Esto es independiente de la presencia del sistema, que es la lista en tiempo real
de clientes del Gateway, y de las balizas persistentes node.presence.alive, que
registran cuándo se activó por última vez un nodo móvil sin tratarlo como conectado.
Requisitos
- La aplicación OpenClaw para macOS está emparejada y conectada en modo nodo.
- Se ha concedido el permiso de Accesibilidad a la aplicación OpenClaw firmada.
- Para las alertas de conexión, también se ha concedido el permiso de Notificaciones y el
nodo Mac expone
system.notify.
Actualmente, los informes de actividad están implementados por el nodo nativo de macOS. Los hosts de nodos iOS, Android, watchOS y sin interfaz gráfica pueden informar del estado de última conexión o actividad en segundo plano, pero no compiten por la designación de equipo activo.
Comprobar el equipo activo
-
En la aplicación para macOS, abra Settings -> Permissions y conceda Accessibility en los ajustes del sistema de macOS.
-
Confirme que el nodo Mac está conectado:
bash openclaw nodes status --connected -
Mueva el ratón o pulse una tecla en ese Mac y, a continuación, ejecute:
bash openclaw nodes statusopenclaw nodes describe --node <node-id-or-name>
El Mac apto con la actividad más reciente se marca como active. La salida de estado muestra la antigüedad de
su última entrada; describe expone active, lastActiveAtMs y presenceUpdatedAtMs.
La actividad se agrupa deliberadamente, por lo que la visualización puede tardar hasta unos 15
segundos en reflejar otra entrada después de un informe reciente.
Cómo se convierte la actividad en presencia
El informador de macOS consulta el reloj de inactividad del sistema HID cada dos segundos. Envía un informe cuando la conexión de un nodo queda lista y, después, informa de nuevas actividades físicas como máximo una vez cada 15 segundos. Mientras está inactivo, envía una señal de mantenimiento cada tres minutos. La duración de la inactividad está limitada a 30 días para que una muestra muy antigua no pueda desplazarse hacia delante y convertirse incorrectamente en la del equipo más reciente.
El Gateway solo acepta la actividad cuando se cumplen todas estas condiciones:
- el evento pertenece a la conexión autenticada actual de ese identificador de nodo;
- el nodo tiene el permiso efectivo
accessibility: true; - la carga útil contiene un valor entero acotado
idleSeconds.
El Gateway resta idleSeconds de su propia hora de observación para obtener
lastActiveAtMs. Nunca confía en una marca de tiempo del reloj del sistema proporcionada por un nodo. Entre
los Mac aptos conectados, gana el lastActiveAtMs más reciente; en caso de empate, se utiliza la
actualización de presencia más reciente.
La presencia es local al proceso y está vinculada a la conexión. Desconectar la sesión actual, sustituirla por otra sesión que utilice el mismo identificador de nodo o revocar Accesibilidad borra el estado de actividad de ese nodo y vuelve a calcular el Mac activo.
Privacidad y contexto del modelo
OpenClaw envía la duración de la inactividad, no el contenido de las entradas. No envía valores de teclas, coordenadas del ratón, nombres de aplicaciones, títulos de ventanas ni eventos de entrada sin procesar. El informador de macOS lee el estado HID del hardware, por lo que los eventos sintéticos de control del equipo no hacen que un Mac automatizado parezca ser el equipo que se utilizó físicamente.
La actividad continua no crea eventos del sistema visibles para el modelo. La línea dinámica del entorno de ejecución contiene únicamente el identificador de nodo autenticado:
active_node=<node-id>Las marcas de tiempo exactas y los nombres para mostrar controlados por los nodos se mantienen fuera del prompt para
evitar la inyección de prompts y la renovación innecesaria de la caché. Cuando el agente necesita detalles actuales,
la herramienta nodes puede leer node.list o node.describe en su lugar.
Cómo se dirigen las alertas de conexión
Después de que un nodo completa su negociación con el Gateway, OpenClaw espera 750 milisegundos para que el Mac que se conecta pueda enviar su primera muestra de actividad. A continuación, intenta utilizar el Mac conectado con capacidad de notificación que tenga la actividad más reciente.
- Si la entrega principal se realiza correctamente, ningún otro Mac recibe la alerta.
- Si no hay ningún Mac activo disponible o la entrega principal falla, OpenClaw espera cinco
segundos e intenta usar todos los demás Mac conectados que exponen
system.notify. - Una alerta de reconexión para el mismo nodo se suprime durante cinco minutos después de un intento real de entrega, lo que evita que las reconexiones inestables generen una avalancha de notificaciones.
Las alertas están vinculadas a conexiones de nodo exactas. Una sesión de origen desconectada o sustituida no puede completar una alerta programada antigua, y una conexión de destino sustitutiva aún puede participar en la entrega alternativa.
Solución de problemas
| Síntoma | Comprobación |
|---|---|
Ninguna fila está marcada como active |
Confirme que hay un nodo nativo de macOS conectado y que openclaw nodes describe --node <id> muestra permissions.accessibility: true. |
| El Mac incorrecto sigue activo | Utilice físicamente ese Mac, espere a que termine el intervalo de agrupación y vuelva a ejecutar openclaw nodes status. Las acciones sintéticas de control del equipo no cuentan. |
| Los datos de la última entrada desaparecen | Compruebe si el Mac se desconectó, si se sustituyó su sesión de nodo o si se revocó Accesibilidad. Cada una de estas condiciones borra intencionadamente la actividad. |
| La alerta aparece en varios Mac | La entrega principal no estaba disponible o falló, por lo que se ejecutó la alternativa retrasada. Compruebe que el Mac activo esté conectado, permita notificaciones y exponga system.notify. |
| El agente no menciona el Mac activo | Inicie un nuevo turno después de que cambie la actividad. La indicación del entorno de ejecución es estable y compacta; utilice la herramienta nodes para consultar los metadatos actuales exactos. |
Para recuperar los permisos de TCC, consulte permisos de macOS. Para los fallos de conexión y comandos de nodos, consulte Solución de problemas de Node.
