核心用法
OpenClaw Menu Bar 是一款专为 macOS 设计的原生菜单栏应用,让用户能够从系统菜单栏快速访问 OpenClaw 聊天功能。安装后,用户将在菜单栏看到一个螃蟹 🦀 图标,点击即可弹出 480×680px 的独立聊天窗口,支持 Cmd+Shift+O 全局快捷键切换。
主要功能
- 菜单栏常驻图标:基于 Electron 构建,使用 menubar 库实现原生体验
- 即时弹窗交互:无需浏览器,点击图标直接唤起聊天界面
- 自动身份认证:读取
~/.openclaw/openclaw.json配置,自动完成登录 - 轻量架构:Electron + BrowserView 加载 OpenClaw webchat,支持 macOS vibrancy 视觉效果
安装与使用
scripts/install.sh # 安装依赖 scripts/start.sh # 启动应用
支持自定义图标(22×22 和 44×44 透明 PNG)、窗口尺寸及键盘快捷键。
显著优点
1. 效率提升:减少打开浏览器→输入地址→等待加载的步骤,实现秒级唤起
2. 原生体验:Proper macOS 菜单栏集成,支持暗黑模式、快捷键、置顶显示
3. 独立进程:与浏览器分离,避免标签页混乱和意外关闭
4. 灵活配置:支持自定义图标、窗口大小、快捷键绑定
潜在缺点与局限性
1. 平台独占:仅限 macOS,Windows 和 Linux 用户无法使用
2. 依赖 Electron:相比原生 Swift 应用,内存占用较高(约 100-200MB)
3. 前置依赖:必须同时运行 OpenClaw Gateway 本地服务
4. 维护成本:Node.js + Electron 版本更新可能带来兼容性问题
5. 图标限制:需严格遵循 22×22/44×44 PNG 规格,且 macOS 强制单色模板渲染可能限制设计自由度
适合人群
- macOS 重度用户:习惯通过菜单栏管理工具(Bartender、Raycast 等)的效率爱好者
- 高频使用者:每日多次使用 OpenClaw,追求最快访问路径
- 极简主义者:希望减少浏览器标签页,保持工作区整洁
- 快捷键依赖者:偏好键盘驱动的工作流(Cmd+Shift+O 快速唤起)
常规风险
1. 运行依赖:若 OpenClaw Gateway 未启动,弹窗会显示 "OpenClaw Not Running" 错误
2. 权限问题:首次使用可能需要授予辅助功能或屏幕录制权限(取决于 Electron 版本)
3. 进程残留:异常退出时可能留下僵尸进程,需使用 scripts/stop.sh 或手动清理
4. 配置泄露风险:~/.openclaw/openclaw.json 包含认证信息,需确保文件权限正确(建议 600)
5. 自动更新缺失:当前实现无自动更新机制,需手动重新安装以获取修复