active, fournir à l’agent une indication stable du nœud actif et acheminer
les alertes de connexion des nœuds vers l’ordinateur où vous êtes le plus probablement présent.
Cela est distinct de la présence système, qui correspond à la liste en temps
réel des clients du Gateway, ainsi que des balises persistantes node.presence.alive, qui
enregistrent le dernier réveil d’un nœud mobile sans le considérer comme connecté.
Prérequis
- L’application OpenClaw pour macOS est appairée et connectée en mode nœud.
- L’autorisation Accessibility est accordée à l’application OpenClaw signée.
- Pour les alertes de connexion, l’autorisation Notifications est également accordée et le
nœud Mac expose
system.notify.
Vérifier l’ordinateur actif
- Dans l’application macOS, ouvrez Settings -> Permissions et accordez Accessibility dans les réglages système de macOS.
-
Vérifiez que le nœud Mac est connecté :
-
Déplacez la souris ou appuyez sur une touche sur ce Mac, puis exécutez :
active. La sortie d’état affiche
le temps écoulé depuis sa dernière entrée ; describe expose active, lastActiveAtMs et
presenceUpdatedAtMs. L’activité est délibérément regroupée ; l’affichage peut donc prendre
jusqu’à environ 15 secondes pour refléter une nouvelle entrée après un signalement récent.
Conversion de l’activité en présence
Le rapporteur macOS échantillonne l’horloge d’inactivité du système HID toutes les deux secondes. Il effectue un signalement lorsqu’une connexion de nœud devient prête, puis signale toute nouvelle activité physique au maximum une fois toutes les 15 secondes. Pendant l’inactivité, il envoie un signal de maintien toutes les trois minutes. La durée d’inactivité est plafonnée à 30 jours afin qu’un échantillon très ancien ne puisse pas dériver vers le futur et être considéré à tort comme celui de l’ordinateur le plus récent. Le Gateway accepte l’activité uniquement lorsque toutes les conditions suivantes sont remplies :- l’événement appartient à la connexion actuellement authentifiée pour cet identifiant de nœud ;
- le nœud dispose effectivement de l’autorisation
accessibility: true; - la charge utile contient une valeur entière bornée
idleSeconds.
idleSeconds de son propre instant d’observation pour calculer
lastActiveAtMs. Il ne se fie jamais à un horodatage d’horloge murale fourni par un nœud. Parmi
les Mac éligibles connectés, celui dont la valeur lastActiveAtMs est la plus récente l’emporte ;
en cas d’égalité, la mise à jour de présence la plus récente est utilisée.
La présence est locale au processus et liée à la connexion. La déconnexion de la session actuelle,
son remplacement par une autre session utilisant le même identifiant de nœud ou la révocation de
l’autorisation Accessibility efface l’état d’activité de ce nœud et recalcule le Mac actif.
Confidentialité et contexte du modèle
OpenClaw envoie la durée d’inactivité, et non le contenu des entrées. Il n’envoie ni les valeurs des touches, ni les coordonnées de la souris, ni les noms des applications, ni les titres des fenêtres, ni les événements d’entrée bruts. Le rapporteur macOS lit l’état matériel HID ; les événements synthétiques de contrôle informatique ne font donc pas apparaître un Mac automatisé comme l’ordinateur que vous avez utilisé physiquement. Une activité continue ne crée pas d’événements système visibles par le modèle. La ligne dynamique de l’environnement d’exécution contient uniquement l’identifiant de nœud authentifié :nodes peut lire node.list ou node.describe.
Acheminement des alertes de connexion
Une fois qu’un nœud a terminé sa négociation avec le Gateway, OpenClaw attend 750 millisecondes afin que le Mac en cours de connexion puisse envoyer son premier échantillon d’activité. Il tente ensuite d’utiliser le Mac connecté capable d’afficher des notifications dont l’activité est la plus récente.- Si la distribution principale réussit, aucun autre Mac ne reçoit l’alerte.
- Si aucun Mac actif n’est disponible ou si la distribution principale échoue, OpenClaw attend cinq
secondes, puis essaie chaque autre Mac connecté qui expose
system.notify. - Une alerte de reconnexion pour le même nœud est supprimée pendant cinq minutes après une tentative réelle de distribution, ce qui empêche les reconnexions répétées de produire une avalanche de notifications.
Résolution des problèmes
| Symptôme | Vérification |
|---|---|
Aucune ligne n’est marquée active | Vérifiez qu’un nœud macOS natif est connecté et que openclaw nodes describe --node <id> affiche permissions.accessibility: true. |
| Le mauvais Mac reste actif | Utilisez physiquement le Mac concerné, attendez la fin de la fenêtre de regroupement, puis réexécutez openclaw nodes status. Les actions synthétiques de contrôle ne comptent pas. |
| Les données de dernière entrée disparaissent | Vérifiez si le Mac s’est déconnecté, si sa session de nœud a été remplacée ou si l’autorisation Accessibility a été révoquée. Chacune de ces conditions efface volontairement l’activité. |
| L’alerte apparaît sur plusieurs Mac | La distribution principale était indisponible ou a échoué ; la procédure de secours différée a donc été exécutée. Vérifiez que le Mac actif est connecté, autorise les notifications et expose system.notify. |
| L’agent ne mentionne pas le Mac actif | Commencez un nouveau tour après un changement d’activité. L’indication d’environnement d’exécution est stable et compacte ; utilisez l’outil nodes pour obtenir les métadonnées actuelles exactes. |