Your ClawdBot command center. Start, stop, manage skills, run commands β all from one sleek desktop UI.
ClawdBot Control Panel is a native desktop application for managing your ClawdBot AI gateway. Built with PyQt6, it works on Windows and macOS β giving you full control over your personal AI assistant without touching the terminal.
Website Β· Docs Β· Skills Hub Β· Discord
- Start/Stop Service - One-click gateway management
- Real-time Logs - Live streaming of gateway output
- Status Monitoring - Visual indicators (Running/Stopped/Not Installed)
- Open Gateway - Quick access to
http://127.0.0.1:18789 - Open Dashboard - Launch web UI with authentication token
- Install Skills - Humanizer, self-improving-agent, and more
- Skills Management - View and manage installed skills
- Open Skills Folder - Direct access to skills directory
- Update/Uninstall - Full lifecycle management
- Run Any Command - Execute with admin privileges
- PowerShell Integration - UAC elevation on Windows
- Real-time Output - Live command streaming
- Copy/Clear Logs - Easy log management
- Version Info - Current and latest version display
- Check Updates - One-click update checking
- Reset/Uninstall - Maintenance operations
- Dark Theme - Easy on the eyes
- Sidebar Navigation - Dashboard, ClawdHub, Terminal, Settings
- Quick Links - Skills Hub & Documentation
- Responsive Design - Polished, professional look
- Python 3.13 or higher
- Windows 10/11 or macOS
- ClawdBot installed (for full functionality)
# Clone the repository
git clone https://github.com/SSujitX/clawdbot-ui.git
cd clawdbot-ui
# Install dependencies and run
uv sync
uv run main.py# Clone the repository
git clone https://github.com/SSujitX/clawdbot-ui.git
cd clawdbot-ui
# Create virtual environment
python -m venv .venv
.venv\Scripts\activate # Windows
source .venv/bin/activate # macOS/Linux
# Install dependencies
pip install -r requirements.txt
# Run the application
python main.pyTo build a standalone executable for Windows (with the application icon):
-
Install Build Dependencies:
uv add pyinstaller
-
Run the Build Script:
./build_exe.ps1This will generate a single-file executable in the
dist/directory:dist/ClawdBot-Control-Panel.exe
- Launch the application
- Navigate to Dashboard
- Click Start Service
- View live logs in the terminal panel
- Navigate to ClawdHub
- Enter skill name (e.g.,
humanizer) - Click Install
- Monitor progress in the log panel
- Navigate to Terminal
- Enter your command (e.g.,
clawdbot configure) - Click Execute
- Approve UAC prompt if required (Windows)
- ClawdHub Skills - Browse available skills
- Documentation - Official ClawdBot docs
| Component | Technology |
|---|---|
| UI Framework | PyQt6 |
| Package Manager | UV |
| Language | Python 3.13+ |
| Styling | Custom Dark Theme CSS |
| Process Management | QThread + subprocess |
clawdbot-ui/
βββ main.py # Entry point
βββ pyproject.toml # Project configuration
βββ src/
β βββ app.py # Application setup
β βββ ui/
β β βββ window.py # Main window (4 pages)
β β βββ terminal.py # Log viewer widget
β β βββ command_dialog.py # Modal command runner
β β βββ styles.py # Dark theme CSS
β βββ core/
β β βββ process.py # Background process runner
β β βββ version.py # Version checking
β βββ utils/
β βββ platform.py # Platform detection + skills utilities
βββ .agent/skills/ # Development skills
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- ClawdBot - The AI gateway this UI controls
- PyQt6 - Python bindings for Qt
- UV - Fast Python package manager
Made with β€οΈ for developers who take control
Made with β€οΈ for the ClawdBot community
