clawpanel/README.en.md at 8da8a24702c7280b8a3103afe7fe801c5556261d

GithubBackup/clawpanel

Fork 0

mirror of https://github.com/qingchencloud/clawpanel.git synced 2026-05-07 06:22:53 +08:00

Files

晴天 465285e3ff docs: add contributor acknowledgements

2026-03-18 18:55:31 +08:00

18 KiB

Raw Blame History

OpenClaw Management Panel with Built-in AI Assistant — One-click Install, Configure, Diagnose & Fix

🇨🇳 中文 | 🇺🇸 English

ClawPanel is a visual management panel for the OpenClaw AI Agent framework. It features a built-in intelligent AI assistant that helps you install OpenClaw with one click, auto-diagnose configurations, troubleshoot issues, and fix errors. 8 tools + 4 modes + interactive Q&A — easy to manage for beginners and experts alike.

🌐 Website: claw.qt.cool | 📦 Download: GitHub Releases

Features

Dashboard & Monitoring

Real-time Dashboard — Gateway status, version info, agent fleet, model pool, service health at a glance
Log Viewer — Real-time Gateway logs with search and filtering
System Diagnostics — Auto-detect configuration issues, WebSocket connectivity, pairing status

AI Assistant (Built-in)

8 Built-in Tools — Terminal execution, file read/write, directory browsing, web search, URL fetching, system info, process management, port checking
4 Modes — Full auto, semi-auto, read-only, chat-only
Tool Calling — AI can directly execute commands, read logs, modify configs to diagnose and fix problems
QingchenCloud Integration — Free partial model access for panel users, premium models at 2-3x discount for paid users

Model Configuration

Multi-Provider — OpenAI, Anthropic, DeepSeek, Google Gemini, Ollama, SiliconFlow, Volcengine, Alibaba Cloud, and more
One-click Model Add — Browse and select models from QingchenCloud catalog
Model Testing — Test any model with a single click before deploying
Primary/Fallback — Set primary model with automatic fallback to alternatives

Agent Management

Multi-Agent — Create and manage multiple AI agents with independent workspaces
Identity & Personality — Configure name, emoji, model for each agent
Memory Files — Manage SOUL.md, IDENTITY.md, AGENTS.md workspace files
Workspace Isolation — Each agent has its own memory, tools, and configuration

Messaging Channels

QQ Bot — Built-in QQ robot integration via QQ Open Platform
Telegram — Bot Token authentication
Discord — Bot with guild/channel management
Feishu/Lark — Enterprise messaging with WebSocket mode
DingTalk — Enterprise app with Stream mode robot
Multi-Account — Bind different accounts to different agents

Gateway & Services

Gateway Control — Start, stop, restart OpenClaw Gateway
Auto-Guardian — Automatic Gateway restart on unexpected exit (with cooldown)
Config Editor — Direct JSON editor for openclaw.json with syntax validation
Backup & Restore — One-click configuration backup and restore

Cron Jobs

Scheduled Tasks — Create cron-based scheduled AI tasks
Delivery Channels — Route task results to messaging channels
Per-Agent Assignment — Assign tasks to specific agents

Security

Access Password — Protect Web panel with password authentication
Network Proxy — Configure HTTP/SOCKS proxy for all outbound requests
Session Management — Secure session tokens with expiration

Installation

Desktop App (Windows / macOS / Linux)

Download the latest installer from GitHub Releases:

Platform	Download
Windows	`.exe` installer (recommended) or `.msi`
macOS Apple Silicon	`.dmg` (aarch64)
macOS Intel	`.dmg` (x64)
Linux	`.AppImage` / `.deb` / `.rpm`

Web Version (No Rust/Tauri Required)

For headless servers, Raspberry Pi, ARM boards, or Docker:

git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel
npm install
npm run serve
# Open http://localhost:1420 in your browser

ARM / Embedded Device Support

ClawPanel provides a pure Web deployment mode (zero GUI dependency), natively compatible with ARM64 boards:

Orange Pi / Raspberry Pi / RK3588 — npm run serve to run
Docker ARM64 — docker run ghcr.io/qingchencloud/openclaw:latest
Armbian / Debian / Ubuntu Server — Auto-detect architecture
No Rust / Tauri / GUI needed — only Node.js 18+ required

Quick Start

Install and open ClawPanel
First run auto-detects Node.js environment and OpenClaw CLI
If OpenClaw is not installed, click one-click install (R2 CDN accelerated)
After installation, the dashboard loads automatically

Requirements: Node.js 18+ (22 LTS recommended)

Tech Stack

Frontend: Vanilla JS + CSS Custom Properties (zero framework dependency)
Desktop: Tauri v2 (Rust backend)
Web Backend: Node.js (Express-compatible API server)
Build: Vite
CI/CD: GitHub Actions (cross-platform builds)

Development

# Prerequisites: Node.js 22+, Rust toolchain, Tauri CLI

# Clone
git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel

# Install dependencies
npm install

# Desktop development (Tauri)
npm run tauri dev

# Web-only development
npm run serve