跳转至

菜单栏

Open Dashboard 和 Gateway 窗口操作默认使用 Web 体验。在 Dashboard → Settings → This Mac → App 下启用 Native experience (Experimental) 即可使用原生聊天窗口。该偏好适用于菜单栏、Dock、主 Gateways 菜单以及 File → New Gateway Window…(Cmd-N)。Settings 始终打开 Web Dashboard 设置页面。有关切换行为与原生聊天功能,请参阅 WebChat。

显示内容

  • 菜单栏图标和菜单的第一行状态显示当前 agent 工作状态。
  • 工作活动期间隐藏健康状态;所有会话空闲后恢复显示。
  • 根菜单中的 Context 项会打开一个包含最近会话的子菜单,而不是在根菜单中展开它们。
  • 根菜单中的 Devices 块仅列出已配对的 devices(来自 node.list),不包含客户端/在线状态条目。
  • 当 provider 用量快照可用时,根菜单的 Usage 部分会出现在 Context 下方,随后在可用时显示费用详情。Today 的费用总额和每日图表使用 Mac 的本地时区。
  • 当有两个或更多 Gateway 可用时,第一行状态会包含主 Gateway 的名称。根菜单的 Gateways 部分随后会列出每个 Gateway,并显示其健康状态和“主”标记。选择一行会在所选体验中打开或聚焦该 Gateway。按住 Option 可对符合条件的已保存 Gateway 显示 Set as Primary…。
  • Quick Chat 打开浮动的主会话撰写器。其当前全局快捷键显示在该项旁边。
  • Settings…(Cmd-,)打开 Dashboard 设置。应用和设备偏好位于 This Mac 下,语音控制位于 Talk 下,应用更新偏好位于 Updates 下。
  • Connection… 打开原生 Connection 窗口。这是一个标准的 macOS 设置窗口,带有 Connection 和 Gateways 工具栏标签。启用开发者开关后,Debug 也会出现。即使 Gateway 不可达,该窗口仍然可用。
  • About OpenClaw 会在原生 Connection 窗口中选择 About,显示应用版本、构建信息、资源链接以及 Copy Build Info。它在没有 Gateway 连接时也可用。

应用的主 Gateways 菜单始终存在。它列出主 Gateway(如果已配置),如果本机还托管本地 Gateway,则随后列出 This Mac,然后是已保存的 Gateway,并依次分配 Command-1 到 Command-9。每张卡片显示健康状态、版本和缩短的构建 ID、端点、延迟,以及所选体验中打开的窗口数量(如有)。通过浏览器认证的配置文件还会显示 Access 及其会话过期时间。Primary 徽章标识主 Gateway。前置窗口标记跟随所选体验中最前面的 Gateway 窗口。选择卡片会在所选体验中打开该 Gateway,或将已有窗口带到最前。按住 Option 可显示 New … Window,或按 Option-Command 加同一数字。两种方式都会为该 Gateway 打开另一个独立窗口。Manage Gateways… 打开 Connection → Gateways,并且在没有配置任何 Gateway 时仍然可用。

右键点击 OpenClaw Dock 图标可访问 Open Dashboard 和 Settings…。当配置了多个 Gateway 时,Dock 菜单也会列出同一目录中的每个 Gateway,包括主 Gateway、可用的 This Mac 以及已保存的配置文件。选择一项会在所选体验中打开或聚焦它;勾选标记标识该体验中最前面的 Gateway 窗口。

Gateway 状态点跟随每个打开的 Dashboard 的实时连接,包括非主 Gateway 的已保存 Gateway。绿色表示已连接,红色表示连接错误,灰色表示当前没有连接结果。如果多个窗口显示同一个 Gateway,只要其中任何一个已连接,它就保持绿色。勾选标记标识所选窗口的 Gateway;Primary 是单独设置。

Gateway 健康检查仅在主 Gateways 菜单打开时运行。刷新期间卡片显示缓存信息,或在首个结果前显示 checking…。失败后,它们显示 unreachable 并附上上次成功联系的时间。关闭菜单会取消其检查,并断开那些用于检查且没有打开 Web 或 Native 窗口的已保存 Gateway。主连接保持连接,缓存信息在应用退出前仍可用。

Devices 和 Automations 摘要会在菜单打开时刷新。关闭菜单会停止它们由菜单持有的轮询。重新打开同一个 Primary Gateway 时,缓存的摘要仍然可用。切换 Primary 会从新选择的 Gateway 刷新 Devices、Automations、Usage 和费用详情。可在 Dashboard 的 Cron Jobs 页面管理任务。

Automations 摘要显示已启用任务的总数,并预览最多八个按下次运行时间排序的任务。

手动 Cron 刷新和成功的任务变更会取代较早的读取结果。因此,进行中的响应无法将已删除的任务恢复到列表中。

状态模型

  • 来源:WorkActivityStore(apps/macos/Sources/OpenClaw/WorkActivityStore.swift)。
  • 事件以 ControlAgentEvent 形式到达,并带有 runId。处理器(ControlChannel.routeWorkActivity)从事件负载中读取 sessionKey,如果缺失则默认为 "main"。
  • 优先级:主会话(默认 sessionKey == "main")始终优先。如果主会话处于活动状态,则立即显示其状态。如果主会话空闲,则改为显示最近处于活动状态的非主会话。该 store 不会在活动进行中切换。它只会在当前会话变为空闲或主会话变为活动状态时切换。
  • 活动类型:
  • job:高级命令执行(state: started|streaming|done|error|...)。
  • tool:phase: start|result,带 name,可选 meta/args。

IconState 枚举(Swift)

  • idle
  • workingMain(ActivityKind)
  • workingOther(ActivityKind)
  • overridden(ActivityKind)(调试覆盖)

ActivityKind -> 徽章符号

ActivityKind 包装了一个 ToolKind(bash、read、write、edit、attach、other)或一个裸 job。每个都会映射为一个绘制在 critter 图标之上的 SF Symbol 徽章(IconState.badgeSymbolName):

类型 符号
bash chevron.left.slash.chevron.right
read doc
write pencil
edit pencil.tip
attach paperclip
other / job gearshape.fill

视觉映射

  • idle:普通小生物,无徽章。
  • workingMain:带符号的徽章,完整着色(.primary 突出度),腿部“working”动画。
  • workingOther:带符号的徽章,柔和着色(.secondary 突出度),无快速移动动画。
  • overridden:无论实际活动如何,均使用所选符号/着色。

上下文子菜单

  • 根菜单显示一个“上下文”行,包含会话计数/状态。该行打开子菜单(MenuSessionsInjector)。
  • 子菜单头部显示最近 24 小时内的活动会话数。
  • 每个会话行保留其 Token 栏、时长、预览、thinking/verbose 切换、重置、compact 和删除操作。
  • 加载、断开连接以及会话加载错误消息在上下文子菜单内渲染。
  • 用量和成本部分保持在根级,位于上下文下方,因此无需打开子菜单即可一目了然。

状态行文本(菜单)

  • 当存在两个或更多 Gateway 时,连接标签会追加主 Gateway 的目录显示名称,例如 OpenClaw Active — Mac Studio。
  • 当工作处于活动状态时:<Session role> · <activity label>(在 MenuContentView 中为 "\(roleLabel) · \(activity.label)"),其中角色标签为 Main 或 Other。
  • 空闲时:回退到健康摘要。

事件摄取

  • 来源:控制通道 agent 事件,由 ControlChannel.routeWorkActivity(from:) 路由。
  • 解析字段:
  • stream: "job" 使用 data.state 表示开始/停止。
  • stream: "tool" 使用 data.phase、data.name,可选 data.meta/data.args。
  • 工具标签来自 ToolDisplayRegistry.resolve(name:args:meta:)。未解析的名称回退到原始工具名称。

调试覆盖

  • 在 仪表盘 → 设置 → 此 Mac → 开发者 中启用开发者开关。然后打开 连接… → 调试 → 图标覆盖:
  • System (auto)(默认)
  • Working: main / Working: other(按工具类型:bash、read、write、edit、other)
  • Idle
  • 存储在 UserDefaults 键 openclaw.iconOverride 下,并映射到 IconState.overridden。

测试清单

  • 触发主会话任务:图标立即切换,状态行显示主标签。
  • 在主会话空闲时触发非主会话任务:图标/状态显示非主会话,并保持稳定直到其完成。
  • 在另一个会话活动时启动主会话:图标立即切换到主会话。
  • 快速工具突发:徽章不会闪烁(清除已完成工具前有 2 秒宽限期,WorkActivityStore.toolResultGrace)。
  • 所有会话空闲后,健康行重新出现。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw