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

此命令会生成一个简单的螃蟹表情图标。

选项二：自定义图标

将生成的图标替换为你自己的 22×22 和 44×44 透明 PNG 文件。

注意：macOS 菜单栏使用单色模板模式（自动为图标着色）。

窗口大小

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

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

键盘快捷键

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

globalShortcut.register('CommandOrControl+Shift+O', () => {
  // 将 'O' 替换为任意键
});

架构

• Electron 应用：基于 [menubar](https://github.com/maxogden/menubar) 包
• 头部：自定义 HTML 头部（index-webchat.html），包含品牌信息
• 内容：通过 BrowserView 加载 OpenClaw webchat，并附带认证令牌
• 自动认证：从 ~/.openclaw/openclaw.json 读取网关配置

要求

• macOS（菜单栏应用仅适用于 macOS）
• OpenClaw Gateway 在本地运行
• Node.js（用于 Electron）

故障排查

图标未显示

• 图标必须是 22×22 像素、透明背景的 PNG 格式
• macOS 菜单栏使用单色模板模式（自动着色）

“OpenClaw Not Running” 错误

• 确保 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 — 检查应用是否在运行