Skip to content

Control Panel UI for ClawdBot - your personal AI assistant. Manage gateway, install skills, run admin commands. 🦞

Notifications You must be signed in to change notification settings

SSujitX/clawdbot-ui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

86 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🦞 ClawdBot Control Panel

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

Python PyQt6 Platform License

πŸ“Έ Preview

ClawdBot Control Panel

✨ Features

πŸŽ›οΈ Gateway Control

  • 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

πŸ“¦ ClawdHub Skills Manager

  • 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

πŸ’» Admin Terminal

  • 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

βš™οΈ Settings & Maintenance

  • Version Info - Current and latest version display
  • Check Updates - One-click update checking
  • Reset/Uninstall - Maintenance operations

🎨 Modern UI

  • Dark Theme - Easy on the eyes
  • Sidebar Navigation - Dashboard, ClawdHub, Terminal, Settings
  • Quick Links - Skills Hub & Documentation
  • Responsive Design - Polished, professional look

πŸ“‹ Requirements

  • Python 3.13 or higher
  • Windows 10/11 or macOS
  • ClawdBot installed (for full functionality)

πŸš€ Installation

Using UV (Recommended)

# 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

Using pip

# 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.py

πŸ› οΈ Building Locally

To build a standalone executable for Windows (with the application icon):

  1. Install Build Dependencies:

    uv add pyinstaller
  2. Run the Build Script:

    ./build_exe.ps1

    This will generate a single-file executable in the dist/ directory: dist/ClawdBot-Control-Panel.exe

πŸ“– Usage

Starting the Gateway

  1. Launch the application
  2. Navigate to Dashboard
  3. Click Start Service
  4. View live logs in the terminal panel

Installing Skills

  1. Navigate to ClawdHub
  2. Enter skill name (e.g., humanizer)
  3. Click Install
  4. Monitor progress in the log panel

Running Admin Commands

  1. Navigate to Terminal
  2. Enter your command (e.g., clawdbot configure)
  3. Click Execute
  4. Approve UAC prompt if required (Windows)

πŸ”— Quick Links

πŸ› οΈ Tech Stack

Component Technology
UI Framework PyQt6
Package Manager UV
Language Python 3.13+
Styling Custom Dark Theme CSS
Process Management QThread + subprocess

πŸ“ Project Structure

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

🀝 Contributing

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

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • ClawdBot - The AI gateway this UI controls
  • PyQt6 - Python bindings for Qt
  • UV - Fast Python package manager

Made with ❀️ for developers who take control

Star History

Visitors


Made with ❀️ for the ClawdBot community

About

Control Panel UI for ClawdBot - your personal AI assistant. Manage gateway, install skills, run admin commands. 🦞

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published