菜单栏上下文监控

macOS 菜单栏实时显示 OpenClaw agent 的上下文用量、模型和运行状态。基于 [SwiftBar](https://github.com/swiftbar/SwiftBar)。

macOS 菜单栏中实时展示 OpenClaw agent 的上下文使用情况、模型信息与运行状态，由 [SwiftBar](https://github.com/swiftbar/SwiftBar) 支持。

版本： 1.2.0

平台： 仅支持 macOS

作者： [@hjklasdfg](https://github.com/hjklasdfg)

源码： [GitHub](https://github.com/hjklasdfg/context-monitor)

功能特性

• 🔧 菜单栏显示最近活跃 agent 的表情符号 + 上下文用量（例如 🔧 140k）
• 📊 下拉菜单列出所有 agent，包含上下文 token 数量、模型别名及最后活跃时间
• 🫠 当上下文超过 100k token 时显示警告标识
• ▶ / — / ✖ 分别表示运行中、空闲、失败状态
• 🏠 支持本地运行或通过 SSH 连接远程 OpenClaw 主机

截图示例

🔧 98k                          ← 菜单栏显示
───────────────────────────────
🦞 OpenClaw Agents (6)
───────────────────────────────
▶ 🔧 tech    98k/1000k (9%)  │ opus   │ 26s ago
— 🎮 main    50k/1000k (5%)  │ opus   │ 2m ago
— 🎯 career  52k/1000k (5%)  │ opus   │ 1m ago
— ✍️ content 40k/1000k (4%)  │ opus   │ 20h ago
— 💰 finance 52k/200k (26%)  │ haiku  │ 1h ago
✖ 🧠 phil    26k/1000k (2%)  │ opus   │ 3d ago
───────────────────────────────
刷新

安装方式

请根据您的实际部署场景选择对应方案：

场景 A：OpenClaw 在本机运行（本地模式）

所有组件运行在同一台机器上——OpenClaw 和菜单栏监控。

# 1. 使用 OpenClaw CLI 安装该技能
openclaw skills install menubar-context-monitor

# 2. 执行安装脚本
bash ~/.openclaw/skills/context-monitor/scripts/install.sh

场景 B：OpenClaw 在另一台机器运行（远程模式）

最常见配置——OpenClaw 运行在服务器 / Raspberry Pi / Mac Mini 上，您希望在笔记本电脑上使用菜单栏监控。无需在 MacBook 上安装 OpenClaw。

# 1. 克隆仓库
git clone https://github.com/hjklasdfg/openclaw-context-monitor.git
cd openclaw-context-monitor

# 2. 使用您的 OpenClaw 主机 SSH 地址运行安装脚本
bash scripts/install.sh --remote user@host

示例： bash scripts/install.sh --remote linyili@192.168.1.100

需要配置 SSH 密钥认证。若尚未设置，安装程序将引导您完成配置。

替代方式：通过代理协助安装

如果您已在本地运行 OpenClaw，可直接让代理为您执行安装：

“帮我设置 agent 菜单栏监控”

代理将读取本技能并引导您完成配置。

SwiftBar 首次启动

首次启动 SwiftBar 时，会提示您选择一个插件目录。按 Cmd+Shift+G 并粘贴以下路径：

~/Library/Application Support/SwiftBar/Plugins

安装程序会将插件脚本放置于此目录。此操作只需执行一次。

系统要求

• macOS（SwiftBar 仅支持 macOS）
• Python 3
• [SwiftBar](https://github.com/swiftbar/SwiftBar) — 安装程序会提供通过 Homebrew 安装的选项
• SSH 密钥认证（仅远程模式需要）

工作原理

SwiftBar 插件（您的 Mac） → SSH → 状态采集器（OpenClaw 主机） → sessions.json
                            或本地 ↗

系统包含两个核心组件：

1. **openclaw-status.py** — 在 OpenClaw 主机上读取 agent 会话数据
2. **swiftbar-plugin.sh** — 在您的 Mac 上渲染菜单栏内容

自定义配置

Agent 表情符号

从每个 agent 的 IDENTITY.md 文件中读取：

- **Emoji:** 🔧

若未设置，则回退为 agent 名称。

模型名称显示

显示短格式别名：opus、sonnet、haiku、flash、pro。用户在 openclaw.json 中配置的 modelAliases 优先级更高。

常见问题排查

许可协议

MIT

<!-- 以下为代理指令，不会在 ClawHub 显示 -->

代理设置指南

当用户请求设置上下文监控时，请按以下流程操作：

开始前提醒： 此技能需在 Mac 上运行命令。若用户可能使用移动设备：

“此操作需在 Mac 上执行。你现在在 Mac 前吗？若在其他设备上，我稍后会发送可复制的命令。”

步骤 1： 向用户询问：

“OpenClaw 是运行在本机，还是远程机器上？若是远程，请提供 SSH 地址（如 user@hostname）。”

步骤 2（本地模式）： 直接运行安装脚本：

bash scripts/install.sh --yes

步骤 2（远程模式）： 代理无法远程安装 SwiftBar。请执行以下操作：

1. 将状态采集脚本部署到 OpenClaw 主机：

scp scripts/openclaw-status.py <user>@<host>:~/.openclaw/openclaw-status.py

1. 生成包含正确 SSH 地址的完整安装命令，供用户复制粘贴使用。

SwiftBar 安装提示： 若需安装 SwiftBar，请先征得用户同意：

“这需要安装 SwiftBar（一款 macOS 菜单栏工具）。是否允许安装？”

获得确认后，传递 --yes 参数跳过交互式提示。

触发关键词

menu bar, SwiftBar, agent status, agent monitor, observability, dashboard mac, agent context, context monitor, 菜单栏, 上下文显示, agent 监控