在线状态
OpenClaw “在线状态” 是一个轻量级的最佳努力视图，包含：
- 网关 本身，以及
- 连接到网关的客户端（mac 应用、WebChat、CLI 等）
在线状态主要用于渲染 macOS 应用的 实例 标签页，并提供快速的操作员可见性。
在线状态字段（显示内容）
在线状态条目是结构化的对象，包含以下字段：
instanceId（可选但强烈推荐）：稳定的客户端身份（通常是connect.client.instanceId）host：人类友好的主机名ip：最佳努力的 IP 地址version：客户端版本字符串deviceFamily/modelIdentifier：硬件提示mode：ui，webchat，cli，backend，probe，test，node，…lastInputSeconds：自上次用户输入以来的秒数（如果已知）reason：self，connect，node-connected，periodic，…ts：最后更新时间戳（自纪元以来的毫秒数）
生产者（在线状态来源）
在线状态条目由多个来源生成并合并。
1) 网关自身条目
网关在启动时始终会生成一个“自身”条目，以便在任何客户端连接之前，UI 显示网关主机。
2) WebSocket 连接
每个 WS 客户端开始时都会发送一个 connect 请求。握手成功后，网关会为该连接更新或插入一个在线状态条目。
为什么一次性的 CLI 命令不会显示
CLI 经常用于短时间的一次性命令。为了避免在实例列表中产生过多信息，client.mode === "cli" 不会被转换为在线状态条目。
3) system-event 广播
客户端可以通过 system-event 方法发送更丰富的周期性广播。mac 应用使用此方法报告主机名、IP 和 lastInputSeconds。
4) 节点连接（角色：节点）
当一个节点通过网关 WebSocket 使用 role: node 连接时，网关会为该节点更新或插入一个在线状态条目（与其他 WS 客户端相同的流程）。
合并 + 去重规则（为什么 instanceId 重要）
在线状态条目存储在一个单一的内存映射中：
- 条目通过一个 在线状态键 进行索引。
- 最佳键是一个稳定的
instanceId（来自connect.client.instanceId），能够在重启后存活。 - 键不区分大小写。
如果一个客户端在没有稳定 instanceId 的情况下重新连接，可能会显示为一个 重复 行。
TTL 和有限大小
在线状态是有意设计为短暂的：
- TTL： 超过 5 分钟的条目会被清理
- 最大条目数： 200（首先丢弃最旧的）
这保持了列表的新鲜度，并避免了无限制的内存增长。
远程/隧道注意事项（回环 IP）
当一个客户端通过 SSH 隧道/本地端口转发连接时，网关可能会看到远程地址为 127.0.0.1。为了避免覆盖客户端报告的良好 IP，回环远程地址会被忽略。
消费者
macOS 实例标签页
macOS 应用渲染 system-presence 的输出，并根据最后更新的时间应用一个小的状态指示器（活动/空闲/过期）。
调试技巧
- 要查看原始列表，请对网关调用
system-presence。 - 如果看到重复项：
- 确认客户端在握手时发送了一个稳定的
client.instanceId - 确认周期性广播使用相同的
instanceId - 检查连接派生的条目是否缺少
instanceId（预期会有重复）
- 确认客户端在握手时发送了一个稳定的