Clawdbot Gateway Launcher

A cross-platform utility for managing the Clawdbot Gateway with auto-restart, system tray/menu bar integration, and quick access to diagnostics.

Features

• System Tray/Menu Bar - Runs quietly with the Clawdbot icon
• Auto-Restart - Automatically restarts the gateway if it crashes
• Background Operation - Gateway runs hidden by default
• Quick Access - Dashboard, health checks, status, and logs at your fingertips
• Persistent Settings - Your preferences are saved between sessions
• Auto-Start - Optionally start with your operating system

Supported Platforms

Platform	Type	Status
Windows 10/11	System Tray App	Ready
macOS (Intel & Apple Silicon)	Menu Bar / Background Service	Ready

Requirements

• Node.js 22 or later
• Clawdbot CLI installed and configured

Quick Start

Windows

# Clone or download
git clone https://github.com/dmkern03/clawdbot-launcher.git
cd clawdbot-launcher/windows

# Install
powershell -ExecutionPolicy Bypass -File install.ps1

macOS

# Clone or download
git clone https://github.com/dmkern03/clawdbot-launcher.git
cd clawdbot-launcher/macos

# Install
chmod +x install.sh
./install.sh

Usage

Windows System Tray

Right-click the tray icon for the menu:

Menu Item	Description
Show/Hide Window	Toggle gateway terminal visibility
Open Dashboard	Open Control UI in browser
Health Check	Run health check with notification
Status	View full diagnostic status
View Logs	Stream live logs
Restart Gateway	Restart the gateway process
Stop Gateway	Stop the gateway
Settings	Configure dashboard URL, auto-restart, notifications
Exit	Stop gateway and close app

macOS

Use the shell commands after installation:

clawdbot-start      # Start gateway with auto-restart
clawdbot-stop       # Stop gateway
clawdbot-restart    # Restart gateway
clawdbot-dashboard  # Open Control UI
clawdbot-status     # Check if running
clawdbot-logs       # View live logs

Configuration

Settings are stored in JSON format and persist between sessions:

Windows: %USERPROFILE%\ClawdbotLauncher\settings.json macOS: ~/.clawdbot-launcher/settings.json

{
  "DashboardUrl": "http://127.0.0.1:18789/",
  "AutoRestartEnabled": true,
  "AutoRestartIntervalSeconds": 5,
  "ShowBalloonNotifications": true
}

Documentation

• Windows README
• macOS README
• Clawdbot Documentation

Troubleshooting

Gateway won't start

• Verify Clawdbot CLI: clawdbot --version
• Check Node.js: node --version (requires 22+)
• Run diagnostics: clawdbot doctor

Multiple startup items (Windows)

• Check Win+R > shell:startup for duplicates
• Check Task Scheduler for old tasks
• Run the uninstall script to clean up

Uninstallation

Windows

powershell -ExecutionPolicy Bypass -File uninstall.ps1

macOS

./uninstall.sh

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - See LICENSE file for details.

Credits

• Clawdbot - The AI agent gateway

Links

• Clawdbot Documentation
• Report Issues