active, fornecer ao agente uma indicação estável do Node ativo e encaminhar
alertas de conexão de Nodes ao computador em que você provavelmente está presente.
Isso é diferente da presença do sistema, que é a lista em tempo real
de clientes do Gateway, e dos beacons duráveis node.presence.alive, que
registram quando um Node móvel foi ativado pela última vez sem tratá-lo como conectado.
Requisitos
- O aplicativo OpenClaw para macOS está emparelhado e conectado no modo Node.
- A permissão Accessibility foi concedida ao aplicativo OpenClaw assinado.
- Para alertas de conexão, a permissão Notifications também foi concedida e o
Node Mac disponibiliza
system.notify.
Verificar o computador ativo
- No aplicativo para macOS, abra Settings -> Permissions e conceda Accessibility nos Ajustes do Sistema do macOS.
-
Confirme se o Node Mac está conectado:
-
Mova o mouse ou pressione uma tecla nesse Mac e execute:
active. A saída de status mostra há
quanto tempo ocorreu sua última entrada; describe disponibiliza active, lastActiveAtMs e
presenceUpdatedAtMs. A atividade é intencionalmente consolidada, portanto a exibição pode levar
até cerca de 15 segundos para refletir outra entrada após um relatório recente.
Como a atividade se torna presença
O relator do macOS consulta o relógio de inatividade do sistema HID a cada dois segundos. Ele envia um relatório quando a conexão de um Node fica pronta e depois informa novas atividades físicas no máximo uma vez a cada 15 segundos. Durante a inatividade, ele envia um sinal de manutenção a cada três minutos. A duração da inatividade é limitada a 30 dias para que uma amostra muito antiga não avance com o tempo e seja incorretamente considerada a do computador mais recente. O Gateway aceita a atividade somente quando todas estas condições são verdadeiras:- o evento pertence à conexão autenticada atual desse ID de Node;
- o Node tem a permissão efetiva
accessibility: true; - o conteúdo contém um valor inteiro limitado de
idleSeconds.
idleSeconds do seu próprio horário de observação para derivar
lastActiveAtMs. Ele nunca confia em um registro de data e hora do relógio fornecido pelo Node. Entre
os Macs elegíveis conectados, vence o lastActiveAtMs mais recente; em caso de empate, é usada a
atualização de presença mais recente.
A presença é local ao processo e vinculada à conexão. Desconectar a sessão atual,
substituí-la por outra sessão usando o mesmo ID de Node ou revogar
Accessibility limpa o estado de atividade desse Node e recalcula o Mac ativo.
Privacidade e contexto do modelo
O OpenClaw envia a duração da inatividade, não o conteúdo das entradas. Ele não envia valores de teclas, coordenadas do mouse, nomes de aplicativos, títulos de janelas nem eventos brutos de entrada. O relator do macOS lê o estado HID do hardware, portanto eventos sintéticos de controle do computador não fazem um Mac automatizado parecer ser o computador usado fisicamente por você. A atividade contínua não cria eventos de sistema visíveis ao modelo. A linha dinâmica do runtime contém somente o ID de Node autenticado:nodes pode consultar node.list ou node.describe.
Como os alertas de conexão são encaminhados
Depois que um Node conclui o handshake com o Gateway, o OpenClaw aguarda 750 milissegundos para que o Mac em conexão possa enviar sua primeira amostra de atividade. Em seguida, tenta usar o Mac conectado com suporte a notificações que tenha a atividade mais recente.- Se a entrega primária for bem-sucedida, nenhum outro Mac receberá o alerta.
- Se nenhum Mac ativo estiver disponível ou a entrega primária falhar, o OpenClaw aguarda cinco
segundos e tenta todos os outros Macs conectados que disponibilizam
system.notify. - Um alerta de reconexão para o mesmo Node é suprimido por cinco minutos após uma tentativa efetiva de entrega, impedindo que oscilações de reconexão produzam uma enxurrada de notificações.
Solução de problemas
| Sintoma | Verificação |
|---|---|
Nenhuma linha está marcada como active | Confirme se um Node macOS nativo está conectado e se openclaw nodes describe --node <id> mostra permissions.accessibility: true. |
| O Mac errado permanece ativo | Use esse Mac fisicamente, aguarde a janela de consolidação e execute novamente openclaw nodes status. Ações sintéticas de controle do computador não são consideradas. |
| Os dados da última entrada desaparecem | Verifique se o Mac foi desconectado, se a sessão do Node foi substituída ou se Accessibility foi revogada. Cada condição limpa intencionalmente a atividade. |
| O alerta aparece em vários Macs | A entrega primária estava indisponível ou falhou, então o fallback adiado foi executado. Verifique se o Mac ativo está conectado, permite notificações e disponibiliza system.notify. |
| O agente não menciona o Mac ativo | Inicie um novo turno após alterações na atividade. A indicação do runtime é estável e compacta; use a ferramenta nodes para obter os metadados atuais exatos. |