macOS
The macOS app serves as a menu-bar companion, handling permissions and managing gateway connections.
Core Features
- Native notifications and menu-bar status
- System permission management (Notifications, Accessibility, Screen Recording, etc.)
- Local or remote gateway management
- macOS-exclusive tools (Canvas, Camera, Screen Recording)
Operating Modes
Local mode (default): Connects to local gateway or auto-enables launchd service.
Remote mode: Connects to remote gateway via SSH/Tailscale.
LaunchAgent
The app controls the com.clawdbot.gateway LaunchAgent:
# Restart service
launchctl kickstart -k gui/$UID/com.clawdbot.gateway
# Remove service
launchctl bootout gui/$UID/com.clawdbot.gatewayDeep Link
The app registers the clawdbot:// URL scheme:
open 'clawdbot://agent?message=Hello'