active，为智能体提供稳定的活动节点提示，并将节点连接提醒路由到
你最可能正在使用的计算机。
这与系统在线状态不同，后者是 Gateway 网关客户端的实时
名册；它也不同于持久化的 node.presence.alive 信标，后者记录移动节点上次唤醒
的时间，但不会将其视为已连接。
要求
- OpenClaw macOS 应用已配对，并以节点模式连接。
- 已启用 Settings -> Permissions -> Active computer detection。该选项默认关闭。
- 已向签名的 OpenClaw 应用授予 Accessibility 权限。
- 对于连接提醒，还需授予 Notifications 权限，并且
Mac 节点需公开
system.notify。
检查活动计算机
- 在 macOS 应用中，打开 Settings -> Permissions，启用 Active computer detection，并在 macOS 系统设置中授予 Accessibility 权限。
-
确认 Mac 节点已连接：
-
在该 Mac 上移动鼠标或按下按键，然后运行：
active。状态输出会显示其距离上次输入
的时长；describe 会公开 active、lastActiveAtMs 和 presenceUpdatedAtMs。
活动报告会被有意合并，因此在最近一次报告后发生其他输入时，显示内容可能需要
最多约 15 秒才能更新。
活动如何转化为在线状态
macOS 报告器每两秒采样一次 HID 系统空闲时钟。节点连接就绪时，它会报告一次， 此后新发生的物理活动每 15 秒最多报告一次。空闲期间，它每三分钟发送一次 保活消息。空闲时长上限为 30 天，以免非常旧的样本随时间向前漂移并被错误地 认定为最新计算机。 禁用 Active computer detection 会停止采样，并通过当前节点连接发送经过身份验证 的清除事件。Gateway 网关会立即移除该 Mac 保留的活动时间戳，并重新计算活动计算机； 其他节点能力和进行中的工作仍保持连接。如果已连接的 Gateway 网关版本早于此清除操作 的引入时间，Mac 节点会重新连接一次，以便通过断开连接清理来移除保留的活动信息。 仅当以下条件全部满足时，Gateway 网关才会接受活动：- 事件属于该节点 ID 当前经过身份验证的连接；
- 节点具有有效的
accessibility: true权限； - 载荷包含一个有界整数
idleSeconds值。
idleSeconds，从而得出
lastActiveAtMs。它绝不信任节点提供的挂钟时间戳。在已连接的合格 Mac 中，
最新的 lastActiveAtMs 胜出；若时间相同，则采用最近更新在线状态的 Mac。
在线状态仅存在于当前进程中，并绑定到连接。断开当前会话、使用相同节点 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 权限。有关节点
连接和命令失败，请参阅节点故障排查。