Skip to main content
A presença ativa no computador informa ao Gateway qual Node macOS conectado recebeu a entrada física mais recente do mouse ou teclado. O OpenClaw usa esse sinal para marcar um Mac como 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.
No momento, o relatório de atividade é implementado pelo Node nativo do macOS. Hosts de Nodes iOS, Android, watchOS e sem interface gráfica podem informar o estado de conexão ou de última atividade em segundo plano, mas não disputam a designação de computador ativo.

​
Verificar o computador ativo

  1. No aplicativo para macOS, abra Settings -> Permissions e conceda Accessibility nos Ajustes do Sistema do macOS.
  2. Confirme se o Node Mac está conectado:
  3. Mova o mouse ou pressione uma tecla nesse Mac e execute:
O Mac elegível com atividade mais recente é marcado como 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.
O Gateway subtrai 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:
Registros de data e hora exatos e nomes de exibição controlados pelos Nodes ficam fora do prompt para evitar injeção de prompt e alterações frequentes no cache. Quando o agente precisa de detalhes atuais, a ferramenta 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.
Os alertas são vinculados a conexões exatas dos Nodes. Uma sessão de origem desconectada ou substituída não pode concluir um alerta antigo agendado, e uma conexão de destino substituta ainda pode participar da entrega de fallback.

​
Solução de problemas

Para recuperar o TCC, consulte permissões do macOS. Para falhas de conexão e comandos de Nodes, consulte Solução de problemas de Nodes.

​
Relacionados