菜单栏上下文监控器（MenuBar Context Monitor）

在 macOS 菜单栏中实时显示 OpenClaw agent 的上下文用量、所用模型及运行状态。基于 SwiftBar 构建。

通过 SwiftBar 实现在 macOS 菜单栏中对 OpenClaw agent 的实时可观测性。

版本：1.1.0 平台：仅限 macOS 作者：@hjklasdfg 源码：GitHub

功能特性

• 🔧 菜单栏显示最近一次活跃 agent 的 emoji 及上下文用量（例如：🔧 140k）
• 📊 下拉菜单列出所有 agent，包含上下文 token 数、模型别名（model alias）及最后活跃时间
• 🫠 当上下文用量超过 100k tokens 时显示警告标识
• ▶ / — / ✖ 分别表示运行中、空闲和失败状态
• 🏠 支持本地运行，也支持通过 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
───────────────────────────────
Refresh

安装方法

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

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

OpenClaw 与菜单栏监控器均运行在同一台 Mac 上。

# 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 上显示菜单栏监控器。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 密钥认证。若尚未配置，安装脚本将引导您完成设置。

替代方式：向您的 agent 提出请求

若您已在本地运行 OpenClaw，可直接告知您的 agent：

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

agent 将读取该技能并逐步引导您完成安装。

SwiftBar 首次启动说明

SwiftBar 首次启动时，会提示您选择一个 插件文件夹（plugin folder）。请按下 Cmd+Shift+G，然后粘贴以下路径：

~/Library/Application Support/SwiftBar/Plugins

安装脚本会将插件脚本放入该目录。此操作仅需执行一次。

依赖要求

• macOS（SwiftBar 仅支持 macOS）
• Python 3
• SwiftBar — 安装脚本将提供通过 Homebrew 安装的选项
• SSH 密钥认证（仅远程模式需要）

工作原理

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

包含两个核心组件：

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

自定义配置

Agent emoji 显示

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

- **Emoji:** 🔧

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

模型名称显示

显示简短别名：opus、sonnet、haiku、flash、pro。若 openclaw.json 中已配置用户自定义的 modelAliases，则优先使用该配置。

故障排查

许可证

MIT

Agent 配置指南

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

开始前确认：本技能需在 Mac 上执行命令。若用户可能正在使用移动设备，请先确认：

“此操作需在 Mac 上运行。您当前是否在 Mac 前？如果是在其他设备上，我可以稍后为您发送待执行命令。”

步骤 1：向用户提问：

“OpenClaw 是运行在这台 Mac 上，还是运行在远程设备上？如果是远程，请提供 SSH 地址（例如：user@hostname）”

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

bash scripts/install.sh --yes

步骤 2（远程模式）：agent 无法远程为用户 Mac 安装 SwiftBar。请执行以下操作：

1. 将状态采集器部署至 OpenClaw 主机：

   scp scripts/openclaw-status.py :~/.openclaw/openclaw-status.py
   

2. 生成含完整 SSH 目标地址的复制粘贴式安装命令，供用户手动执行。

SwiftBar 安装授权：若需安装 SwiftBar，请先征得用户同意：

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

获得用户确认后，在命令中加入 --yes 参数以跳过脚本的交互式提示。

触发关键词

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