openclaw menubar

🦀 菜单栏一键唤醒,macOS 原生体验

将 OpenClaw 变为 macOS 原生菜单栏应用,一键点击螃蟹图标 🦀 快速唤出聊天窗口,无需打开浏览器

收藏
3.2k
安装
1.3k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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. 自动更新缺失:当前实现无自动更新机制,需手动重新安装以获取修复

openclaw menubar 内容

assets文件夹
openclaw-menubar文件夹
icons文件夹
scripts文件夹
手动下载zip · 70.4 kB
icon-template.svgtext/plain
请选择文件