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

• 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.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

• 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 app
• scripts/install.sh - Install dependencies (npm install)
• scripts/start.sh - Launch the menu bar app
• scripts/stop.sh - Kill the app process
• scripts/status.sh - Check if app is running