clawpanel/README.en.md at 1ef5b45b5b91d0e6b049a602fa56d3dcbd579d99

GithubBackup/clawpanel

Fork 0

mirror of https://github.com/qingchencloud/clawpanel.git synced 2026-08-06 13:43:50 +08:00

Files

晴天 f315d7c084 chore(release): prepare v0.19.1

2026-07-24 02:57:17 +08:00

24 KiB

Raw Blame History

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: Official Download Center | Fallback: GitHub Releases

🧪 Free Testing: QingChen Cloud

QingChen Cloud is ClawPanel's companion check-in testing platform for trials and functional verification. ClawPanel does not include or auto-read a QingChen Cloud key. Sign up and visit the check-in page to obtain testing credits and your own API Key, then paste it into ClawPanel to select and configure models. Current availability and credit rules are shown on QingChen Cloud.

🤝 Sponsored: CiyAPI

Third-party sponsored placement; CiyAPI's current terms apply.

Frontier Models — GPT, Claude, Gemini, Grok, Kimi, and more
Top-up Benefit — ¥1 funds $1 in platform usage credit
Discounted Routes — Selected routes use discounted pricing; see the model marketplace
OpenAI Compatible — Get an API Key and connect through ClawPanel

Register at CiyAPI, create an API Key, and use https://ciyapi.79tian.com/v1 as the OpenAI-compatible Base URL. See the model marketplace for current models and pricing.

🔥 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. ClawPanel Web requires Node.js 18+; OpenClaw Gateway is checked against the installed OpenClaw engines.node requirement, with Node.js 22.19.0+ recommended.

📖 See Armbian Deployment Guide | Web Dev Mode

Community

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

Discord · Telegram · 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
CiyAPI Sponsorship — GPT, Claude, and other models; ¥1 funds $1 in platform usage credit
Extensions — cftunnel tunnel management, ClawApp status monitoring
About — Version info, community links, related projects, one-click upgrade

Download & Install

Go to the official download center for the latest version. It auto-detects your OS and also lets you pick Windows, macOS, or Linux packages manually. GitHub Releases remain available as a fallback.

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

Legacy Frontend Hot Update Files / Rolling Back to Built-in Version

Current ClawPanel desktop updates use full installers downloaded from the official site. The frontend hot update directory is kept only for compatibility with old installations and rollback handling. If you used the old hot update path, files are stored at:

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

If the UI looks broken or you want to revert to the frontend bundled with the installer, 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.

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.

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.

24 KiB Raw Blame History