活跃计算机在场状态¶
活跃计算机在场状态会告知 Gateway 哪个已连接的 macOS 节点收到了最近的活动。基本在场状态在您与 OpenClaw 应用交互时即可生效,无需额外权限。可选的系统级在场检测还会将其他应用中的物理鼠标和键盘活动纳入考量。OpenClaw 利用该信号将一台 Mac 标记为 active,为智能体提供稳定的活跃节点提示,并将节点连接提醒路由到您最可能所在的计算机。
这是一种近期活动提示,并非证明哪台计算机发送了特定聊天消息。活跃 Mac 可能与运行 Gateway 或智能体的计算机不同。设备状态与连接提醒路由会在整个 Gateway 范围内选择最新且有资格的 Mac。而智能体的提示则在与经过身份验证的请求者关联的节点中进行选择,绝不会回退到其他人的机器。共享所有者和未识别身份的对话轮次可能会收到一个未分配的节点提示,该提示明确标记为未知人员身份。
核心在场工具会将这些观察结果与人员和客户端的实时名单相结合。它保留活动来源,并分别标识共享或未分配的机器。持久的 node.presence.alive 信标用于记录移动节点上次唤醒的时间,但不会将其视为已连接,也不据此确立用户活动。
前提条件¶
- OpenClaw macOS 应用已配对并以节点模式连接。
- 与 OpenClaw 应用交互以提供基本在场状态。仅运行应用或将其置于前台并不算活动。
- 要纳入其他应用中的活动,请启用设置 -> 权限 -> 系统级在场检测,并向已签名的 OpenClaw 应用授予辅助功能(Accessibility)权限。系统级检测默认关闭。
- 对于连接提醒,还需授予通知(Notifications)权限,且 Mac 节点暴露
system.notify。
活动报告仅由原生 macOS 节点实现。iOS、Android、watchOS 和无头节点主机可以报告连接或后台最后在线状态,但它们不参与活跃计算机的竞争。
检查活跃计算机¶
- 与 OpenClaw macOS 应用交互。此基本在场信号无需辅助功能权限。要同时检测其他应用中的活动,请启用设置 -> 权限 -> 系统级在场检测,并在 macOS 系统设置中授予辅助功能权限。
- 确认 Mac 节点已连接:
- 在该 Mac 上的 OpenClaw 中点击或输入,然后运行:
最新且有资格的 Mac 会被标记为 active。状态输出显示其距上次输入的时长;describe 暴露 active、lastActiveAtMs 和 presenceUpdatedAtMs。活动报告有意合并,因此在最近一次报告后,显示可能需要最多约 15 秒才能反映另一次输入。
活动如何转化为在场状态¶
macOS 应用会记录 OpenClaw 接收到的本地输入事件。当系统级检测启用且已授予辅助功能权限时,它还会每两秒采样一次 HID 系统空闲时钟。报告会被合并:较新的活动每 15 秒最多发送一次,空闲期间每三分钟发送一次保活信号(keepalive)。空闲时长上限为 30 天,以免非常旧的采样向前漂移并被错误地视为最新计算机。
禁用系统级在场检测或失去辅助功能权限,会清除之前的系统级采样,并在已观察到应用本地活动的情况下回退到应用本地活动。这不会关闭基本在场状态,也不会断开其他节点功能。如果没有应用本地采样,该 Mac 将保持未选中状态,直到您与 OpenClaw 交互。
Gateway 仅在以下所有条件均成立时接受活动:
- 事件属于该节点 ID 的当前经过身份验证的连接;
- 负载包含一个有界整数
idleSeconds值; - 来源为应用本地,或具有有效
accessibility: true权限的系统级来源。没有来源的旧版报告被视为系统级。
Gateway 会从其自身的观察时间中减去 idleSeconds 以得出 lastActiveAtMs。它从不信任节点提供的墙上时钟时间戳。在已连接且有资格的 Mac 中,最新的 lastActiveAtMs 胜出;如果相同,则使用最近的在场状态更新。
在场状态是进程本地且绑定连接的。断开当前会话或用同一节点 ID 的另一个会话替换它,会清除该节点的活动状态并重新计算活跃 Mac。撤销辅助功能权限会使系统级活动失效,但应用本地活动仍然有效。
隐私与模型上下文¶
基本应用本地在场状态无需授予辅助功能权限即可使用。只有系统级检测是用户主动选择启用的,且与用于 UI 自动化的辅助功能授权分开。OpenClaw 发送空闲时长和活动来源,而非输入内容。它不发送按键值、鼠标坐标、应用名称、窗口标题或原始输入事件。
系统级检测读取硬件 HID 状态,因此合成计算机控制事件不算作物理系统级活动。应用本地检测记录传递给 OpenClaw 的输入,并不证明事件来自物理设备。
持续活动不会创建面向模型的系统事件。在对话轮次准备时,动态上下文包含一个紧凑提示,其中仅包含经过身份验证的节点 ID:
当没有已连接且有资格的 Mac 具有当前在场状态时,提示为 active_node=unknown。这会清除先前的选择,而不是让智能体复用已断开的 Mac。它不标识消息的来源设备,也不暗示没有人正在使用计算机。
对于共享所有者或未识别身份的对话轮次,身份标记为 active_node_identity=unknown;该机器上的活动不能确立谁使用了它。具名人员的提示要求有匹配的经过身份验证的节点配置文件。设备名称、IP 地址和单个可见人员无法确立该关联。
精确时间戳和由节点控制的显示名称不会出现在 Prompt 中,以避免 Prompt 注入和缓存抖动。只要所选节点 ID 保持不变,提示就会保持逐字节一致。当代理需要当前详细信息时,presence 工具可以检查请求者及其设备。nodes 工具继续通过 node.list 或 node.describe 读取设备状态和控制能力。
连接警报的路由¶
在节点完成批准后的首次成功 Gateway 握手后,OpenClaw 会等待 750 毫秒,以便正在连接的 Mac 提交其首个活动样本。然后,它会尝试使用具有最新活动的已连接且支持通知的 Mac。
- 如果主要投递成功,则没有其他 Mac 会收到该警报。
- 如果没有可用的活动 Mac,或者主要投递失败,OpenClaw 会等待五秒,然后尝试所有其余已连接且暴露
system.notify的 Mac。 - 后续重连是静默的。Gateway 会在配对元数据中记录成功连接,因此 Gateway 重启不会为每个先前已连接的节点重放警报。
警报绑定到已认证的节点身份。同一节点的替换会话会接管其待处理的首次连接警报;如果投递运行时该节点不再连接,则警报会被取消。
故障排除¶
| 症状 | 检查 |
|---|---|
没有行被标记为 active |
确认已连接原生 macOS 节点,然后在 OpenClaw 中点击或输入。对于 OpenClaw 之外的活动,请启用系统范围检测,并在 openclaw nodes describe --node <id> 中检查 permissions.accessibility: true。 |
| 错误的 Mac 仍保持活动 | 在你想要使用的 Mac 上与 OpenClaw 交互,等待合并窗口,然后重新运行 openclaw nodes status。启用系统范围检测后,其他应用中的物理输入也会被计入。 |
| 最后输入数据消失 | 检查 Mac 是否断开连接或其节点会话是否已被替换。禁用系统范围检测或撤销辅助功能权限会清除系统范围样本;应用本地活动仍可选择该 Mac。 |
| 警报出现在多台 Mac 上 | 主要投递不可用或失败,因此延迟回退已运行。请验证活动 Mac 已连接、允许通知,并暴露 system.notify。 |
| 代理未提及活动 Mac | 在活动变化后开始新一轮。运行时提示稳定且紧凑;请使用 nodes 工具获取精确的当前元数据。 |
有关 TCC 恢复,请参阅 macOS 权限。有关节点连接和命令故障,请参阅 节点故障排除。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw