mannyrepos 215803b4d4 Add native macOS control panel for non-technical users

Adds a SwiftUI-based GUI application that provides:
- Start/Stop/Restart controls for the gateway
- Real-time status monitoring (CPU, memory, uptime)
- Log viewer with search
- Health check integration (clawdbot doctor)
- Channel status display
- Menu bar quick access
- Auto-start on login option
- System notifications

Built for users who prefer a graphical interface over terminal commands.

2026-01-26 01:40:21 -08:00

3.1 KiB

Raw Blame History

Clawdbot Control

A native macOS application for managing Clawdbot. Provides a graphical interface for users who prefer not to use the command line.

Requirements

macOS 13.0 (Ventura) or later
Apple Silicon (ARM64) Mac
Clawdbot installed via Homebrew at /opt/homebrew/bin/clawdbot

Installation

Quick Install

./install.sh

Manual Build

./build.sh
cp -R build/Clawdbot\ Control.app /Applications/

Features

Main Dashboard

Start, stop, and restart the Clawdbot gateway
View running status with uptime display
Monitor CPU and memory usage
View and search logs in real-time
Run health checks (clawdbot doctor)
View channel status (WhatsApp, Signal)

Quick access from the menu bar icon
Start/Stop/Restart controls
Open dashboard
Run health check
Toggle auto-start

Settings

Auto-start on login (via LaunchAgent)
System notifications for status changes
Configurable refresh interval
Log display options

Usage

Opening the App

Spotlight: Press Cmd+Space, type "Clawdbot", press Enter
Menu Bar: Click the antenna icon in the top-right corner
Applications: Double-click in /Applications/Clawdbot Control.app

Basic Controls

Action	Description
Start	Starts the Clawdbot gateway
Stop	Stops the Clawdbot gateway
Restart	Stops and starts the gateway
Dashboard	Opens the web dashboard at http://127.0.0.1:18789
Health Check	Runs `clawdbot doctor` diagnostics

Enable auto-start from the Settings sidebar. This creates a LaunchAgent at:

~/Library/LaunchAgents/com.clawdbot.autostart.plist

File Structure

clawdbot-control-app/
├── src/
│   ├── main.swift      # SwiftUI application source
│   └── Info.plist      # Application metadata
├── resources/
│   ├── AppIcon.icns    # Application icon
│   └── icon_1024.png   # Icon source image
├── build.sh            # Build script
├── install.sh          # Build and install script
└── README.md

Configuration

The app reads Clawdbot configuration from:

~/.clawdbot/clawdbot.json

Logs are read from:

/tmp/clawdbot/clawdbot-YYYY-MM-DD.log

Technical Details

Language: Swift 5 with SwiftUI
Frameworks: AppKit, SwiftUI, UserNotifications
Architecture: Native ARM64
Bundle ID: com.clawdbot.control

Troubleshooting

App does not detect Clawdbot

Ensure Clawdbot is installed at /opt/homebrew/bin/clawdbot. The app expects this path for Homebrew installations on Apple Silicon Macs.

The app must be running for the menu bar icon to appear. Check Activity Monitor for "ClawdbotControl" process.

Auto-start not working

Check that the LaunchAgent file exists at ~/Library/LaunchAgents/com.clawdbot.autostart.plist
Run launchctl list | grep clawdbot to verify it is loaded
Check Console.app for any error messages

License

MIT License

3.1 KiB Raw Blame History