活跃的计算机状态

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

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

要求

• OpenClaw macOS 应用已配对，并以节点模式连接。
• 已向签名的 OpenClaw 应用授予 Accessibility 权限。
• 对于连接提醒，还需授予 Notifications 权限，并且 Mac 节点需公开 system.notify。

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

检查活跃计算机

1. 在 macOS 应用中，打开 Settings -> Permissions，然后在 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 天，避免非常旧的样本随时间向前漂移，并被错误地 视为最新的计算机。

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

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

Gateway 网关从自身的观测时间中减去 idleSeconds，以推导出 lastActiveAtMs。它绝不会信任节点提供的挂钟时间戳。在已连接且符合条件的 Mac 中，lastActiveAtMs 最新者胜出；若时间相同，则采用最近更新存在状态的 Mac。

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

隐私和模型上下文

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。
• 对于同一节点，在实际尝试投递后的五分钟内会抑制重连提醒，防止反复重连产生 通知风暴。

提醒绑定到确切的节点连接。已断开或被替换的源会话无法完成旧的计划提醒，而替换后的 目标连接仍可参与回退投递。

故障排查

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

相关内容

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