Nodes and media

Actieve computeraanwezigheid

Actieve computeraanwezigheid vertelt de Gateway welk verbonden macOS-Node de meest recente fysieke muis- of toetsenbordinvoer heeft ontvangen. OpenClaw gebruikt dat signaal om één Mac als active te markeren, de agent een stabiele hint voor de actieve Node te geven en meldingen over Node-verbindingen te routeren naar de computer waarbij je waarschijnlijk aanwezig bent.

Dit staat los van systeemaanwezigheid, de live lijst met Gateway-clients, en van duurzame node.presence.alive-bakens, die vastleggen wanneer een mobiele Node voor het laatst actief werd zonder deze als verbonden te beschouwen.

Vereisten

De OpenClaw-app voor macOS is gekoppeld en verbonden in Node-modus.
Settings -> Permissions -> Active computer detection is ingeschakeld. Dit is standaard uitgeschakeld.
De machtiging Accessibility is verleend aan de ondertekende OpenClaw-app.
Voor verbindingsmeldingen is ook de machtiging Notifications verleend en stelt de Mac-Node system.notify beschikbaar.

Activiteitsrapportage is momenteel geïmplementeerd door de native macOS-Node. iOS, Android, watchOS en headless Node-hosts kunnen de verbindingsstatus of de achtergrondstatus van de laatste waarneming rapporteren, maar dingen niet mee naar de aanduiding als actieve computer.

De actieve computer controleren

Open in de macOS-app Settings -> Permissions, schakel Active computer detection in en verleen Accessibility in de macOS-systeeminstellingen.
Controleer of de Mac-Node is verbonden:
bash
```
openclaw nodes status --connected
```
Beweeg de muis of druk op een toets op die Mac en voer daarna het volgende uit:
bash
```
openclaw nodes statusopenclaw nodes describe --node <node-id-or-name>
```

De meest recent actieve geschikte Mac wordt gemarkeerd als active. De statusuitvoer toont hoe lang geleden de laatste invoer plaatsvond; describe stelt active, lastActiveAtMs en presenceUpdatedAtMs beschikbaar. Activiteit wordt bewust samengevoegd, waardoor het na een recente rapportage tot ongeveer 15 seconden kan duren voordat nieuwe invoer in de weergave zichtbaar wordt.

Hoe activiteit aanwezigheid wordt

De macOS-rapporteur bemonstert elke twee seconden de inactiviteitsklok van het HID-systeem. Deze rapporteert eenmaal wanneer een Node-verbinding gereed is en rapporteert daarna nieuwere fysieke activiteit niet vaker dan eenmaal per 15 seconden. Tijdens inactiviteit verzendt deze elke drie minuten een keepalive. De inactiviteitsduur is beperkt tot 30 dagen, zodat een zeer oud meetpunt niet vooruit kan verschuiven en ten onrechte de nieuwste computer kan worden.

Als je Active computer detection uitschakelt, stopt de bemonstering en wordt een geverifieerde wisgebeurtenis via de huidige Node-verbinding verzonden. De Gateway verwijdert onmiddellijk de bewaarde activiteitstijdstempels van die Mac en bepaalt de actieve computer opnieuw; andere Node-mogelijkheden en lopende werkzaamheden blijven verbonden. Als de verbonden Gateway ouder is dan deze wisactie, maakt de Mac-Node eenmaal opnieuw verbinding, zodat opschoning bij het verbreken van de verbinding de bewaarde activiteit kan verwijderen.

De Gateway accepteert activiteit alleen als aan al deze voorwaarden is voldaan:

de gebeurtenis behoort tot de huidige geverifieerde verbinding voor die Node-id;
de Node heeft daadwerkelijk de machtiging accessibility: true;
de payload bevat een begrensde gehele waarde voor idleSeconds.

De Gateway trekt idleSeconds af van zijn eigen waarnemingstijd om lastActiveAtMs af te leiden. Een door een Node opgegeven tijdstempel van de systeemklok wordt nooit vertrouwd. Van de verbonden geschikte Macs wint de nieuwste lastActiveAtMs; bij een gelijke stand wordt de meest recente aanwezigheidsupdate gebruikt.

Aanwezigheid is lokaal voor het proces en gebonden aan de verbinding. Als de huidige sessie wordt verbroken, wordt vervangen door een andere sessie met dezelfde Node-id, of als Accessibility wordt ingetrokken, wordt de activiteitsstatus van die Node gewist en wordt de actieve Mac opnieuw bepaald.

Privacy en modelcontext

Het delen van activiteit is standaard uitgeschakeld en staat los van de Accessibility-machtiging die voor UI-automatisering wordt gebruikt. OpenClaw verzendt de inactiviteitsduur, niet de inhoud van de invoer. Het verzendt geen toetswaarden, muiscoördinaten, applicatienamen, venstertitels of onbewerkte invoergebeurtenissen. De macOS-rapporteur leest de HID-hardwarestatus, zodat synthetische gebeurtenissen voor computerbesturing er niet voor zorgen dat een geautomatiseerde Mac wordt aangemerkt als de computer die je fysiek hebt gebruikt.

Continue activiteit creëert geen systeemgebeurtenissen die zichtbaar zijn voor het model. De dynamische runtimeregel bevat alleen de geverifieerde Node-id:

text

active_node=<node-id>

Exacte tijdstempels en door Nodes beheerde weergavenamen blijven buiten de prompt om promptinjectie en cacheverloop te voorkomen. Wanneer de agent actuele details nodig heeft, kan de tool nodes in plaats daarvan node.list of node.describe lezen.

Hoe verbindingsmeldingen worden gerouteerd

Nadat een Node na goedkeuring de eerste succesvolle Gateway-handshake heeft voltooid, wacht OpenClaw 750 milliseconden, zodat de verbindende Mac zijn eerste activiteitsmeting kan indienen. Daarna probeert OpenClaw de verbonden Mac met meldingsmogelijkheden en de meest recente activiteit.

Als de primaire bezorging slaagt, ontvangt geen enkele andere Mac de melding.
Als er geen actieve Mac beschikbaar is of de primaire bezorging mislukt, wacht OpenClaw vijf seconden en probeert het elke overige verbonden Mac die system.notify beschikbaar stelt.
Latere nieuwe verbindingen verlopen zonder melding. De Gateway registreert de geslaagde verbinding in de koppelingsmetadata, zodat een herstart van de Gateway niet opnieuw meldingen afspeelt voor elke eerder verbonden Node.

Meldingen zijn gebonden aan de geverifieerde Node-identiteit. Een vervangende sessie voor dezelfde Node neemt de uitstaande melding voor de eerste verbinding over; als die Node niet meer verbonden is wanneer de bezorging wordt uitgevoerd, wordt de melding geannuleerd.

Problemen oplossen

Symptoom	Controle
Geen enkele rij is gemarkeerd als `active`	Controleer of detectie van de actieve computer is ingeschakeld, een native macOS-Node is verbonden en `openclaw nodes describe --node <id>` `permissions.accessibility: true` toont.
De verkeerde Mac blijft actief	Gebruik die Mac fysiek, wacht tot het samenvoegingsvenster is verstreken en voer `openclaw nodes status` opnieuw uit. Synthetische computerbesturingsacties tellen niet mee.
Gegevens over de laatste invoer verdwijnen	Controleer of de verbinding met de Mac is verbroken, de Node-sessie is vervangen of Accessibility is ingetrokken. Elke voorwaarde wist de activiteit bewust.
De melding verschijnt op meerdere Macs	De primaire bezorging was niet beschikbaar of is mislukt, waardoor de vertraagde terugvalroute is uitgevoerd. Controleer of de actieve Mac is verbonden, meldingen toestaat en `system.notify` beschikbaar stelt.
De agent vermeldt de actieve Mac niet	Start een nieuwe beurt nadat de activiteit is gewijzigd. De runtimehint is stabiel en compact; gebruik de tool `nodes` voor exacte actuele metadata.

Zie macOS-machtigingen voor TCC-herstel. Zie voor problemen met Node-verbindingen en opdrachten Problemen met Nodes oplossen.

Gerelateerd

Was this useful?