clawdbot-macos-build
Build the Clawdbot macOS menu bar app from source. Use when you need to install the Clawdbot.app companion (for menu bar status, permissions, and Mac hardware access like camera/screen recording). Han
Build the Clawdbot macOS menu bar app from source. Use when you need to install the Clawdbot.app companion (for menu bar status, permissions, and Mac hardware access like camera/screen recording). Han
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
The macOS companion app provides menu-bar status, native notifications, and access to Mac hardware (camera, screen recording, system commands). This skill builds it from source.
# Clone repo cd /tmp && rm -rf clawdbot-build && git clone https://github.com/clawdbot/clawdbot.git clawdbot-buildInstall + build
cd /tmp/clawdbot-build pnpm install pnpm ui:build
Accept Xcode license (one-time)
sudo xcodebuild -license accept
Build macOS app with ad-hoc signing
ALLOW_ADHOC_SIGNING=1 bash scripts/package-mac-app.sh
Install to /Applications
cp -r dist/Clawdbot.app /Applications/Clawdbot.app
Launch
open /Applications/Clawdbot.app
Clones the latest Clawdbot source from GitHub. This includes the macOS app source in
apps/macos/.
Installs Node.js dependencies for the entire workspace (~1 minute). Warnings about missing binaries in some extensions are harmless.
Compiles the Control UI (Vite → TypeScript/React). Output goes to
dist/control-ui/. Takes ~30 seconds.
Required once per Xcode update. If you get "license not agreed" errors during Swift build, run:
sudo xcodebuild -license accept
Runs the full Swift build pipeline:
Signing options:
ALLOW_ADHOC_SIGNING=1 — good for local testing, app won't notarize for distributionSIGN_IDENTITY="Developer ID Application: <name>" if you have a signing certificateThis step takes 10-20 minutes depending on your Mac.
Copies the built app to the system Applications folder so it runs like any other macOS app.
Opens the app. On first run, you'll see permission prompts (Notifications, Accessibility, Screen Recording, etc.) — approve them for full functionality.
Swift build requires 6.2+. Update Xcode:
softwareupdate -i -a
sudo xcodebuild -license accept
Use ad-hoc signing for local builds:
ALLOW_ADHOC_SIGNING=1 bash scripts/package-mac-app.sh
xcode-select --install or update via App Storedf -h (need ~30GB free)Check that it's properly signed:
codesign -v /Applications/Clawdbot.app
If signing failed, rebuild with
ALLOW_ADHOC_SIGNING=1.
clawdbot:// URL schemeSee the official docs: https://docs.clawd.bot/platforms/macos
For production distribution, you'll need:
For personal use, ad-hoc signing is fine.
After the app launches:
clawdbot gateway status)Then from the terminal, you can manage the Gateway:
clawdbot gateway status clawdbot gateway restart
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.