> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/nl/concepts/presence), 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

1. Open in de macOS-app **Settings -> Permissions**, schakel
   **Active computer detection** in en verleen **Accessibility** in de macOS-systeeminstellingen.

2. Controleer of de Mac-Node is verbonden:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw nodes status --connected
   ```

3. Beweeg de muis of druk op een toets op die Mac en voer daarna het volgende uit:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw nodes status
   openclaw 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/nl/platforms/mac/permissions) voor TCC-herstel. Zie voor
problemen met Node-verbindingen en opdrachten [Problemen met Nodes oplossen](/nl/nodes/troubleshooting).

## Gerelateerd

* [Nodes](/nl/nodes)
* [Nodes-CLI](/nl/cli/nodes)
* [Systeemaanwezigheid](/nl/concepts/presence)
* [Gateway-protocol](/nl/gateway/protocol#presence)
* [macOS-app](/nl/platforms/macos)
