clawpanel/README.en.md at main · qingchencloud/clawpanel

OpenClaw & Hermes Agent Management Panel with Built-in AI Assistant — Multi-Engine AI Framework Management

ClawPanel is a visual management panel supporting multiple AI Agent frameworks, currently with OpenClaw and Hermes Agent dual-engine support. It features a built-in intelligent AI assistant that helps you install, 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

🎁 QingchenCloud AI API

Internal technical testing platform, open for selected users. Sign in daily to earn credits.

Daily Sign-in Credits — Sign in daily + invite friends to earn test credits
OpenAI-Compatible API — Seamless integration with OpenClaw, plug and play
Resource Policy — Rate limiting + request caps, may queue during peak hours
Model Availability — Models/APIs subject to actual page display, may rotate versions

⚠️ Compliance: This platform is for technical testing only. Illegal use or circumventing security mechanisms is prohibited. Keep your API Key secure. Rules subject to latest platform policies.

🔥 Dev Board / 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

📖 See Armbian Deployment Guide | Web Dev Mode

Community

A community of passionate AI Agent developers and enthusiasts — join us!

Discord · Discussions · Report Issue

Features

🤖 AI Assistant (New) — Built-in AI assistant, 4 modes + 8 tools + interactive Q&A. See AI Assistant Highlights
🧩 Multi-Engine Architecture — Supports both OpenClaw and Hermes Agent dual engines, freely switchable, independently managed
🤖 Hermes Agent Chat — Built-in Hermes Agent chat interface with tool call visualization, file system access toggle, SSE streaming output
🖼️ Image Recognition — Paste screenshots or drag images, AI auto-analyzes, multimodal conversations
Dashboard — System overview, real-time service monitoring, quick actions
Service Management — OpenClaw / Hermes Gateway start/stop, version detection & one-click upgrade, config backup & restore
Model Configuration — Multi-provider management, model CRUD, batch connectivity tests, latency detection, drag-to-reorder, auto-save + undo
Gateway Configuration — Port, access scope (localhost/LAN), auth Token, Tailscale networking
Messaging Channels — Unified Telegram, Discord, Feishu, DingTalk, QQ management, multi-Agent binding per platform
Communication & Automation — Message settings, broadcast strategies, slash commands, Webhooks, execution approval
Usage Analytics — Token usage, API costs, model/provider/tool rankings, daily usage charts
Agent Management — Agent CRUD, identity editing, model config, workspace management
Chat — Streaming, Markdown rendering, session management, /fast /think /verbose /reasoning commands
Cron Jobs — Cron-based scheduled execution, multi-channel delivery
Log Viewer — Multi-source real-time logs with keyword search
Memory Management — Memory file view/edit, categorized management, ZIP export, Agent switching
QingchenCloud AI API — Internal testing platform, OpenAI-compatible, daily sign-in credits
Extensions — cftunnel tunnel management, ClawApp status monitoring
About — Version info, community links, related projects, one-click upgrade

Download & Install

Go to Releases for the latest version:

macOS

Chip	Installer	Notes
Apple Silicon (M1/M2/M3/M4)	`ClawPanel_x.x.x_aarch64.dmg`	Macs from late 2020+
Intel	`ClawPanel_x.x.x_x64.dmg`	Macs 2020 and earlier

⚠️ "Damaged" or "unverified developer"? App is unsigned. Run: sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app

Windows

Format	Installer	Notes
EXE	`ClawPanel_x.x.x_x64-setup.exe`	Recommended
MSI	`ClawPanel_x.x.x_x64_en-US.msi`	Enterprise / silent install

Linux

Format	Installer	Notes
AppImage	`ClawPanel_x.x.x_amd64.AppImage`	No install, `chmod +x` and run
DEB	`ClawPanel_x.x.x_amd64.deb`	`sudo dpkg -i *.deb`
RPM	`ClawPanel-x.x.x-1.x86_64.rpm`	`sudo rpm -i *.rpm`

Linux Server (Web Version)

curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash

Visit http://YOUR_SERVER_IP:1420 after deployment. 📖 Linux Deployment Guide

Docker

docker run -d --name clawpanel --restart unless-stopped \
  -p 1420:1420 -v clawpanel-data:/root/.openclaw \
  node:22-slim \
  sh -c "apt-get update && apt-get install -y git && \
    npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com && \
    git clone https://github.com/qingchencloud/clawpanel.git /app && \
    cd /app && npm install && npm run build && npm run serve"

📖 Docker Deployment Guide

Quick Start

Initial Setup — First launch auto-detects Node.js, Git, OpenClaw. One-click install if missing.
Configure Models — Add AI providers (DeepSeek, MiniMax, OpenAI, Ollama, etc.) with API keys. Test connectivity.
Start Gateway — Go to Service Management, click Start. Green status = ready.
Start Chatting — Go to Live Chat, select model, start conversation with streaming & Markdown.

🤖 AI Assistant Highlights

Built-in AI assistant that can directly operate your system — diagnose, fix, even submit PRs.

Four Modes

Mode	Icon	Tools	Write	Confirm	Use Case
Chat	💬	❌	❌	—	Pure Q&A
Plan	📋	✅	❌	✅	Read configs/logs, output plans
Execute	⚡	✅	✅	✅	Normal work, dangerous ops need confirm
Unlimited	∞	✅	✅	❌	Full auto, no prompts

Eight Tools

Tool	Function
`ask_user`	Ask user questions (single/multi/text)
`get_system_info`	Get OS, architecture, home directory
`run_command`	Execute shell commands
`read_file` / `write_file`	Read/write files
`list_directory`	Browse directories
`list_processes`	View processes
`check_port`	Check port usage

Tech Architecture

Layer	Technology	Description
Frontend	Vanilla JS + Vite	Zero framework, lightweight
Backend	Rust + Tauri v2	Native performance, cross-platform
Communication	Tauri IPC + Shell Plugin	Frontend-backend bridge
Styling	Pure CSS (CSS Variables)	Dark/Light themes, glassmorphism

Build from Source

git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel && npm install

# Desktop (requires Rust + Tauri v2)
npm run tauri dev        # Development
npm run tauri build      # Production

# Web only (no Rust needed)
npm run dev              # Dev with hot reload
npm run build && npm run serve  # Production

FAQ

Hot Update Caused UI Issues / Rolling Back to Built-in Version

ClawPanel desktop supports frontend hot updates. Update files are stored at:

OS	Path
Windows	`%USERPROFILE%\.openclaw\clawpanel\web-update\`
macOS / Linux	`~/.openclaw/clawpanel/web-update/`

If the UI looks broken after a hot update or you want to revert to the version bundled with the installer, simply delete that directory and restart:

# macOS / Linux
rm -rf ~/.openclaw/clawpanel/web-update

# Windows PowerShell
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw\clawpanel\web-update"

After restarting ClawPanel, the built-in frontend resources will be used automatically.

Related Projects

Project	Description
OpenClaw	AI Agent Framework
ClawApp	Cross-platform mobile chat client
cftunnel	Cloudflare Tunnel tool

Contributing

Issues and Pull Requests are welcome. See CONTRIBUTING.md for guidelines.

Acknowledgements

ClawPanel keeps growing because of every contributor in the community. Thank you for helping make the project better.

Code Contributors

Thanks to these developers for submitting Pull Requests and contributing directly to the codebase:

_liucong2013
#88

_axdlee
#58

_ATGCS
#107

_livisun
#106

_kiss-kedaya
#101 #94

_wzh4869
#82

_0xsline
#15

_jonntd
#18

Community Reporters

Thanks to community members who opened issues, reported bugs, and suggested features:

If we missed your contribution, please open an issue and we will add it promptly.

Sponsor

If you find this project useful, consider supporting us via USDT (BNB Smart Chain):

0xbdd7ebdf2b30d873e556799711021c6671ffe88f

Contact

Email: support@qctx.net
Website: qingchencloud.com
Product: claw.qt.cool

License

This project is licensed under AGPL-3.0. For commercial/proprietary use without open-source requirements, contact us for a commercial license.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🎁 QingchenCloud AI API

🔥 Dev Board / Embedded Device Support

Community

Features

Download & Install

macOS

Windows

Linux

Linux Server (Web Version)

Docker

Quick Start

🤖 AI Assistant Highlights

Four Modes

Eight Tools

Tech Architecture

Build from Source

FAQ

Hot Update Caused UI Issues / Rolling Back to Built-in Version

Related Projects

Contributing

Acknowledgements

Code Contributors

Community Reporters

Sponsor

Contact

License

FilesExpand file tree

README.en.md

Latest commit

History

README.en.md

File metadata and controls

🎁 QingchenCloud AI API

🔥 Dev Board / Embedded Device Support

Community

Features

Download & Install

macOS

Windows

Linux

Linux Server (Web Version)

Docker

Quick Start

🤖 AI Assistant Highlights

Four Modes

Eight Tools

Tech Architecture

Build from Source

FAQ

Hot Update Caused UI Issues / Rolling Back to Built-in Version

Related Projects

Contributing

Acknowledgements

Code Contributors

Community Reporters

Sponsor

Contact

License