OpenClaw 菜单栏应用

⚠️ 仅限 macOS — 此功能仅支持 macOS。Windows 和 Linux 不支持菜单栏应用。

为 macOS 添加原生菜单栏应用，实现快速访问 OpenClaw —— 点击菜单栏中的螃蟹图标 🦀，即可立即弹出聊天窗口。

快速开始

安装与启动

scripts/install.sh
scripts/start.sh

螃蟹图标将出现在您的菜单栏中。点击该图标即可打开聊天窗口。

停止运行

scripts/stop.sh

检查运行状态

scripts/status.sh

功能说明

• 菜单栏图标：螃蟹 🦀 图标显示在 macOS 菜单栏中
• 快速弹窗：点击图标 → 即刻弹出聊天窗口（无需浏览器）
• 键盘快捷键：使用 Cmd+Shift+O 切换弹窗显示/隐藏
• 原生体验：支持 macOS 毛玻璃（vibrancy）效果，必要时始终置顶
• 轻量级设计：基于 Electron 构建，弹窗尺寸约为 480×680 像素

图标配置

菜单栏应用需在 assets/openclaw-menubar/icons/ 目录下提供两个图标文件：

• icon.png（22×22 像素，透明 PNG）
• icon@2x.png（44×44 像素，透明 PNG）

方式一：自动生成图标

cd assets/openclaw-menubar
./create-icon.sh

该脚本将生成一个基于螃蟹 emoji 的简易图标。

方式二：使用自定义图标

用您自己的 22×22 和 44×44 像素透明 PNG 文件替换已生成的图标。

注意：macOS 菜单栏以单色模板模式（monochrome template mode）渲染图标（系统会自动着色）。

窗口尺寸

编辑 assets/openclaw-menubar/main.js 文件：

browserWindow: {
  width: 480,  // 修改宽度
  height: 680  // 修改高度
}

键盘快捷键

编辑 assets/openclaw-menubar/main.js 文件：

globalShortcut.register('CommandOrControl+Shift+O', () => {
  // 将 'O' 替换为您希望使用的任意按键
});

架构说明

• Electron 应用，基于 menubar 包构建
• 页眉：使用自定义 HTML 页眉（index-webchat.html），含品牌标识
• 内容区域：通过 BrowserView 加载 OpenClaw Web Chat，并携带认证 token
• 自动认证：从 ~/.openclaw/openclaw.json 中读取网关（gateway）配置

运行要求

• macOS（菜单栏应用为 macOS 特有功能）
• 本地运行中的 OpenClaw Gateway
• Node.js（用于运行 Electron）

故障排查

图标未显示

• 图标必须为 22×22 像素、带透明背景的 PNG 文件
• macOS 菜单栏采用单色模板模式（自动着色）

出现“OpenClaw 未运行”错误

• 请确认 OpenClaw Gateway 正在运行：openclaw gateway status
• 检查配置文件：cat ~/.openclaw/openclaw.json

窗口无法打开

• 在 Console.app 中查看日志（搜索关键词 “OpenClaw”）
• 尝试执行：scripts/stop.sh && scripts/start.sh

相关文件

• assets/openclaw-menubar/ — 完整的 Electron 应用目录
• scripts/install.sh — 安装依赖（执行 npm install）
• scripts/start.sh — 启动菜单栏应用
• scripts/stop.sh — 终止应用进程
• scripts/status.sh — 检查应用是否正在运行