openclaw menubar
by @prab002
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.
clawhub install openclaw-menubarπ About This Skill
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.sh
The crab icon will appear in your menu bar. Click it to open the chat window.
Stop
scripts/stop.sh
Check Status
scripts/status.sh
What It Does
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.sh
This 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
~/.openclaw/openclaw.jsonRequirements
Troubleshooting
Icon not showing
"OpenClaw Not Running" error
openclaw gateway statuscat ~/.openclaw/openclaw.jsonWindow doesn't open
scripts/stop.sh && scripts/start.shFiles
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π‘ Examples
Install & Launch
scripts/install.sh
scripts/start.sh
The crab icon will appear in your menu bar. Click it to open the chat window.
Stop
scripts/stop.sh
Check Status
scripts/status.sh
π Tips & Best Practices
Icon not showing
"OpenClaw Not Running" error
openclaw gateway statuscat ~/.openclaw/openclaw.jsonWindow doesn't open
scripts/stop.sh && scripts/start.sh