Documentation Index
Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
Use this file to discover all available pages before exploring further.
菜单栏状态逻辑
显示内容
- 我们会在菜单栏图标以及菜单的第一行状态中展示当前代理的工作状态。
- 在工作进行时会隐藏健康状态；当所有会话都处于空闲时，它会重新出现。
- 根级 “Context” 子菜单会包含最近会话，而不是直接在根菜单中展开它们。
- 根菜单中的 “Nodes” 区块仅列出 设备（通过
node.list配对的节点），不包含客户端/存在状态条目。 - 当可用提供方使用情况快照时，根级 “Usage” 区块会显示在 Context 下方，若可用则随后显示使用成本详情。
状态模型
- 会话：事件会携带
runId（每次运行的）以及载荷中的sessionKey。 “main” 会话的键为main；如果缺失，则回退到最近更新的会话。 - 优先级：main 始终优先。如果 main 处于活动状态，会立即显示其状态。如果 main 处于空闲，则显示最近活跃的非 main 会话。我们不会在活动过程中来回切换；只有当当前会话变为空闲，或者 main 变为活动时才会切换。
- 活动类型：
job：高层级命令执行（state: started|streaming|done|error）。tool：phase: start|result，并带有toolName和meta/args。
IconState 枚举（Swift）
idleworkingMain(ActivityKind)workingOther(ActivityKind)overridden(ActivityKind)（调试覆盖）
ActivityKind → glyph
exec→ 💻read→ 📄write→ ✍️edit→ 📝attach→ 📎- default → 🛠️
视觉映射
idle：正常小动物。workingMain：带 glyph 的徽章、完整色调、腿部“工作中”动画。workingOther：带 glyph 的徽章、柔和色调、不快速跑动。overridden：无论活动如何，均使用所选 glyph/色调。
Context submenu
- 根菜单显示一行 “Context”，带有会话计数/状态，并打开一个子菜单。
- Context 子菜单标题显示过去 24 小时内的活动会话数量。
- 每个会话行保留其 token bar、时长、预览、thinking/verbose、reset、compact 和 delete 操作。
- 加载中、断开连接以及会话加载错误消息会显示在 Context 子菜单内。
- 提供方使用情况和使用成本详情保留在 Context 下方的根级，这样无需打开子菜单也能一眼看到。
Status row text (menu)
- 当工作进行时：
<Session role> · <activity label>- 示例：
Main · exec: pnpm test、Other · read: apps/macos/Sources/OpenClaw/AppState.swift。
- 示例：
- 空闲时：回退到健康摘要。
事件接入
- 来源：控制通道
agent事件（ControlChannel.handleAgentEvent）。 - 解析字段：
stream: "job"，使用data.state表示开始/停止。stream: "tool"，使用data.phase、name，以及可选的meta/args。
- 标签：
exec：args.command的第一行。read/write：缩短后的路径。edit：路径加上从meta/diff 数量推断出的变更类型。- fallback：工具名称。
调试覆盖
- 设置 ▸ 调试 ▸ “Icon override” 选择器：
System (auto)（默认）Working: main（按工具类型）Working: other（按工具类型）Idle
- 通过
@AppStorage("iconOverride")存储；映射到IconState.overridden。
测试清单
- 触发 main 会话作业：验证图标立即切换，状态行显示 main 标签。
- 在 main 空闲时触发非 main 会话作业：图标/状态显示非 main；在完成前保持稳定。
- 当其他会话活跃时启动 main：图标立即切换到 main。
- 快速的工具突发：确保徽章不会闪烁（tool 结果上有 TTL 宽限）。
- 当所有会话都空闲后，健康行重新出现。