active，为 agent 提供一个稳定的活动节点提示，并将节点连接警报路由到你最可能所在的那台电脑。
这与 system presence 不同，后者是 Gateway 客户端的实时名单；也不同于持久化的 node.presence.alive 信标，后者记录的是移动节点上次唤醒的时间，但不会将其视为已连接。
要求
- OpenClaw macOS 应用已配对并以 node 模式连接。
- Settings -> Permissions -> Active computer detection 已启用。该功能默认关闭。
- 已向已签名的 OpenClaw 应用授予 Accessibility 权限。
- 对于连接提醒，还需要授予 Notifications 权限，并且
Mac node 暴露
system.notify。
检查当前活动的电脑
- 在 macOS 应用中，打开 Settings -> Permissions，启用 Active computer detection，并在 macOS 系统设置中授予 Accessibility 权限。
-
确认 Mac 节点已连接：
-
在该 Mac 上移动鼠标或按下任意键，然后运行：
active。状态输出会显示其最后输入
的时间间隔；describe 会暴露 active、lastActiveAtMs 和 presenceUpdatedAtMs。
活动会被刻意合并，因此在最近一次报告之后，显示内容最多可能需要大约 15
秒才能反映另一次输入。
活动如何变为在线状态
macOS 报告器每两秒采样一次 HID 系统空闲时钟。它会在节点连接变为就绪时上报一次，然后在之后每 15 秒最多上报一次更新的物理活动。空闲时，它每三分钟发送一次 keepalive。空闲时长上限为 30 天，因此非常久远的采样不会向前漂移并错误地变成最新的电脑。 禁用 Active computer detection 会停止采样，并通过当前节点连接发送一个经过身份验证的清除事件。Gateway 会立即移除该 Mac 保留的活动时间戳，并重新计算当前活跃的电脑；其他节点能力和正在进行的工作会保持连接。如果所连接的 Gateway 早于此次清除操作，这台 Mac 节点会重新连接一次，以便断开连接的清理逻辑可以改为移除保留的活动信息。 Gateway 仅在以下条件全部满足时才接受活动：- 该事件属于该 node id 当前已认证的连接；
- 该节点具有有效的
accessibility: true权限； - 负载中包含有界整数值
idleSeconds。
idleSeconds，从而推导出 lastActiveAtMs。它绝不会信任节点提供的墙上时钟时间戳。在已连接且符合条件的 Mac 之间，lastActiveAtMs 更新最新者获胜；若相同，则以最近的 presence 更新为准。
Presence 是进程本地且与连接绑定的。断开当前会话、用相同的 node id 替换为另一个会话，或撤销 Accessibility，都会清除该节点的活动状态并重新计算当前活跃的 Mac。
隐私和模型上下文
活动共享默认关闭，并且独立于用于 UI 自动化的 Accessibility 授权。OpenClaw 发送的是空闲时长，而不是输入内容。它不会发送按键值、鼠标坐标、应用程序名称、窗口标题或原始输入事件。macOS 报告程序读取硬件 HID 状态，因此合成的计算机控制事件不会让自动化的 Mac 看起来像是你亲自使用的那台电脑。 持续活动不会创建面向模型的系统事件。动态运行时行只包含经过身份验证的节点 ID：nodes 工具可以改为读取 node.list 或 node.describe。
连接提醒的路由方式
在节点完成批准后的第一次成功 Gateway 握手后， OpenClaw 会等待 750 毫秒，以便连接中的 Mac 能提交其首个 活动样本。随后，它会使用最新的活动信息尝试向已连接且具备通知能力的 Mac 发送提醒。- 如果主投递成功，则不会有其他 Mac 收到该提醒。
- 如果没有可用的活跃 Mac，或者主投递失败，OpenClaw 会等待五
秒，然后尝试向所有其余已连接且暴露
system.notify的 Mac 发送提醒。 - 后续重新连接不会触发提醒。Gateway 会在配对元数据中记录成功连接， 因此 Gateway 重启不会为每个先前连接过的节点重新播放提醒。
故障排除
有关 TCC 恢复，请参阅 macOS 权限。有关节点连接和命令失败，请参阅 节点故障排除。