活跃计算机在线状态

活动计算机在线状态会告知 Gateway 网关，哪个已连接的 macOS 节点最近接收了 物理鼠标或键盘输入。OpenClaw 使用该信号将某台 Mac 标记为 active，为智能体提供稳定的活动节点提示，并将节点连接提醒路由到 你最可能正在使用的计算机。

这与系统在线状态不同，后者是 Gateway 网关客户端的实时 名册；它也不同于持久化的 node.presence.alive 信标，后者记录移动节点上次唤醒 的时间，但不会将其视为已连接。

要求

• OpenClaw macOS 应用已配对，并以节点模式连接。
• 已启用 Settings -> Permissions -> Active computer detection。该选项默认关闭。
• 已向签名的 OpenClaw 应用授予 Accessibility 权限。
• 对于连接提醒，还需授予 Notifications 权限，并且 Mac 节点需公开 system.notify。

活动报告目前由原生 macOS 节点实现。iOS、Android、watchOS 和无头节点主机 可以报告连接状态或后台最近在线状态，但它们不会参与活动计算机指定的竞争。

检查活动计算机

1. 在 macOS 应用中，打开 Settings -> Permissions，启用 Active computer detection，并在 macOS 系统设置中授予 Accessibility 权限。

2. 确认 Mac 节点已连接：

   openclaw nodes status --connected

3. 在该 Mac 上移动鼠标或按下按键，然后运行：

   openclaw nodes statusopenclaw nodes describe --node <node-id-or-name>

最新的合格 Mac 会被标记为 active。状态输出会显示其距离上次输入 的时长；describe 会公开 active、lastActiveAtMs 和 presenceUpdatedAtMs。 活动报告会被有意合并，因此在最近一次报告后发生其他输入时，显示内容可能需要 最多约 15 秒才能更新。

活动如何转化为在线状态

macOS 报告器每两秒采样一次 HID 系统空闲时钟。节点连接就绪时，它会报告一次， 此后新发生的物理活动每 15 秒最多报告一次。空闲期间，它每三分钟发送一次 保活消息。空闲时长上限为 30 天，以免非常旧的样本随时间向前漂移并被错误地 认定为最新计算机。

禁用 Active computer detection 会停止采样，并通过当前节点连接发送经过身份验证 的清除事件。Gateway 网关会立即移除该 Mac 保留的活动时间戳，并重新计算活动计算机； 其他节点能力和进行中的工作仍保持连接。如果已连接的 Gateway 网关版本早于此清除操作 的引入时间，Mac 节点会重新连接一次，以便通过断开连接清理来移除保留的活动信息。

仅当以下条件全部满足时，Gateway 网关才会接受活动：

• 事件属于该节点 ID 当前经过身份验证的连接；
• 节点具有有效的 accessibility: true 权限；
• 载荷包含一个有界整数 idleSeconds 值。

Gateway 网关从自身的观测时间中减去 idleSeconds，从而得出 lastActiveAtMs。它绝不信任节点提供的挂钟时间戳。在已连接的合格 Mac 中， 最新的 lastActiveAtMs 胜出；若时间相同，则采用最近更新在线状态的 Mac。

在线状态仅存在于当前进程中，并绑定到连接。断开当前会话、使用相同节点 ID 的其他会话替换当前会话，或撤销 Accessibility 权限，都会清除该节点的活动状态 并重新计算活动 Mac。

隐私和模型上下文

活动共享默认关闭，并且与用于 UI 自动化的 Accessibility 授权相互独立。 OpenClaw 发送的是空闲时长，而非输入内容。它不会发送按键值、鼠标坐标、 应用程序名称、窗口标题或原始输入事件。macOS 报告器读取硬件 HID 状态， 因此合成的计算机控制事件不会让自动化 Mac 看起来像是你亲自使用过的计算机。

持续活动不会创建面向模型的系统事件。动态运行时行仅包含经过身份验证的节点 ID：

active_node=<node-id>

确切时间戳和由节点控制的显示名称不会进入提示词，以避免提示词注入和缓存抖动。 当智能体需要当前详细信息时，nodes 工具可改为读取 node.list 或 node.describe。

连接提醒的路由方式

节点获批后首次成功完成 Gateway 网关握手时，OpenClaw 会等待 750 毫秒， 以便正在连接的 Mac 提交首个活动样本。随后，它会尝试向活动信息最新且支持通知 的已连接 Mac 发送提醒。

• 如果主要投递成功，其他 Mac 不会收到提醒。
• 如果没有可用的活动 Mac，或主要投递失败，OpenClaw 会等待五秒， 然后尝试所有其他公开 system.notify 的已连接 Mac。
• 后续重新连接不会发出提醒。Gateway 网关会将成功连接记录在配对元数据中， 因此 Gateway 网关重启后，不会为每个先前已连接的节点重新发送提醒。

提醒绑定到经过身份验证的节点身份。相同节点的替代会话会接管其待处理的首次连接 提醒；如果执行投递时该节点已不再连接，则取消提醒。

故障排查

有关 TCC 恢复，请参阅 macOS 权限。有关节点 连接和命令失败，请参阅节点故障排查。

相关内容

• 节点
• 节点 CLI
• 系统在线状态
• Gateway 网关协议
• macOS 应用