- slug
- openclaw-menubar
- displayName
- OpenClaw Menu Bar
- description
- Enable OpenClaw as a native macOS menu bar app with quick access popup. macOS ONLY - not compatible with Windows or Linux. Use when user asks to "enable menubar", "add menu bar", "run in menu bar", "make it accessible from menu bar", or wants quick OpenClaw access without opening full dashboard.
OpenClaw Menu Bar
⚠️ macOS ONLY - This skill requires macOS. Menu bar apps are not supported on Windows or Linux.
Adds a native macOS menu bar app for quick OpenClaw access - click the crab icon 🦀 in your menu bar to get an instant chat popup.
Quick Start
Install & Launch
scripts/install.sh
scripts/start.shThe crab icon will appear in your menu bar. Click it to open the chat window.
Stop
scripts/stop.shCheck Status
scripts/status.shWhat It Does
- Menu bar icon: Crab 🦀 icon appears in macOS menu bar
- Quick popup: Click icon → instant chat window (no browser needed)
- Keyboard shortcut: Cmd+Shift+O to toggle popup
- Native feel: Proper macOS vibrancy, stays on top when needed
- Lightweight: Electron app, ~480x680px popup window
Icon Setup
The menubar app requires two icon files in assets/openclaw-menubar/icons/:
icon.png(22x22 pixels, transparent PNG)icon@2x.png(44x44 pixels, transparent PNG)
Option 1: Auto-generate icons
cd assets/openclaw-menubar
./create-icon.shThis creates a simple crab emoji icon.
Option 2: Custom icons
Replace the generated icons with your own 22x22 and 44x44 transparent PNGs.
Note: macOS menu bar uses monochrome template mode (auto-colorizes your icon).
Window Size
Edit assets/openclaw-menubar/main.js:
browserWindow: {
width: 480, // Change width
height: 680 // Change height
}Keyboard Shortcut
Edit assets/openclaw-menubar/main.js:
globalShortcut.register('CommandOrControl+Shift+O', () => {
// Change 'O' to any key
});Architecture
- Electron app using menubar package
- Header: Custom HTML header (index-webchat.html) with branding
- Content: OpenClaw webchat loaded via BrowserView with auth token
- Auto-auth: Reads gateway config from
~/.openclaw/openclaw.json
Requirements
- macOS (menu bar apps are macOS-specific)
- OpenClaw Gateway running on localhost
- Node.js (for Electron)
Troubleshooting
Icon not showing
- Icon must be 22x22 PNG with transparent background
- macOS menu bar uses monochrome template mode (auto-colorizes)
"OpenClaw Not Running" error
- Ensure OpenClaw Gateway is running:
openclaw gateway status - Check config:
cat ~/.openclaw/openclaw.json
Window doesn't open
- Check logs in Console.app (search "OpenClaw")
- Try:
scripts/stop.sh && scripts/start.sh
Files
assets/openclaw-menubar/- Complete Electron appscripts/install.sh- Install dependencies (npm install)scripts/start.sh- Launch the menu bar appscripts/stop.sh- Kill the app processscripts/status.sh- Check if app is running