5.16 在线状态

OpenClaw 的在线状态功能提供"网关本身及连接到网关的客户端的轻量级、尽力而为的视图"。它主要支持 macOS 应用的实例标签页和操作员可见性。

关键数据字段

在线状态条目包含以下可选标识符:

  • instanceId:实例标识
  • 连接详情:hostip
  • 版本信息
  • 硬件提示
  • 操作模式
  • 输入活动时间
  • 更新原因
  • 时间戳

信息来源

在线状态数据从四个来源合并:

  1. 网关自身条目:在启动时建立
  2. WebSocket 连接:当客户端握手时激活(CLI 命令被排除以防止列表杂乱)
  3. 系统事件信标:客户端定期更新,报告主机和活动数据
  4. 节点连接:当节点以适当角色连接时注册

关键去重细节

"条目由存在键作为索引","最佳键是稳定的 instanceId",它在重新连接时保持不变。没有一致的标识符,可能会出现重复条目。

生命周期管理

系统实现自动清理:

  • 超过 5 分钟的条目将被移除
  • 存储上限为 200 个条目
  • 最旧的条目优先被丢弃

重要限制

注意
显示回环地址(127.0.0.1)的 SSH 隧道连接会被有意过滤,以保持客户端报告的 IP 准确性。
提示
更多在线状态的详细信息请参考 官方英文文档