📌 项目简介
ClawPanel 是一个基于 React + TypeScript + Express 的 OpenClaw 智能管理面板，旨在为 OpenClaw 用户提供一个更强大、更直观的可视化管理工具。
项目前身是 openclaw-im-manager（一个简单的 QQ 机器人管理后台），经过 4 个大版本迭代，现已进化为功能完整的 OpenClaw 全能管理面板。
GitHub 地址：https://github.com/zhaoxinyi02/ClawPanel
✨ 核心功能一览
1. 📊 智能仪表盘
动态展示已连接通道卡片、AI 模型状态、运行时间、内存占用、今日消息统计、最近活动流。
亮点：仅显示已连接的通道，未连接的通道不再占位，界面更清爽。
2. 📡 通道管理（20+ 通道）
支持 20+ 种通道的统一配置，分为内置通道和插件通道两大类：
内置通道（8 种）：
| 通道 | 说明 |
|---|---|
| QQ (NapCat) | 扫码/快速/账密登录，唤醒概率、触发词、戳一戳回复、审核请求集成 |
| 微信 | 扫码登录，基于 wechatbot-webhook |
| Telegram | Bot Token + Webhook |
| Discord | Bot Token + Guild 配置 |
| QR 扫码 | |
| Slack | Socket Mode |
| Signal | signal-cli REST API |
| Google Chat | 服务账号 + Webhook |
插件通道（12+ 种）：
飞书 / Lark · 钉钉 · 企业微信 · QQ 官方 Bot · IRC · Mattermost · Microsoft Teams · LINE · Matrix · Twitch · BlueBubbles · WebChat
亮点：
- 已连接的通道自动置顶显示
QQ 审核请求（好友/入群）直接集成在 QQ 通道配置页面中，不再需要单独页面
3. ⚡ 技能中心 + ClawHub 商店
- 已安装技能：从服务端实时扫描 OpenClaw 已安装的插件，一键启用/禁用，搜索筛选
- ClawHub 商店：浏览 13+ 可安装技能，点击即可获取安装命令
4. ⚙️ 系统配置（6 大模块）
这是 v4.1 最大的升级，全新 6 标签页深度配置：
🧠 模型配置（多提供商）
支持 8+ 主流 AI 厂商一键填充：
| 提供商 | 支持模型 |
|---|---|
| OpenAI | GPT-4o, GPT-4o-mini, o1, o3-mini |
| Anthropic | Claude Sonnet 4.5, Claude Haiku 3.5, Claude 3 Opus |
| Gemini 2.0 Flash, Gemini 2.0 Pro, Gemini 1.5 Pro | |
| DeepSeek | DeepSeek Chat, DeepSeek Reasoner |
| NVIDIA NIM | MiniMax, Llama 3.1 405B |
| Groq | Llama 3.3 70B, Mixtral 8x7B |
| Together AI | Llama 3.1 70B Instruct Turbo |
| OpenRouter | 聚合所有厂商模型 |
每个提供商可配置：Base URL、API Key、API 类型、模型列表。点击厂商按钮自动填充 URL。
📦 版本管理
- 当前版本 / 最新版本对比
- 更新检测与提示
- 配置备份与恢复：一键备份 openclaw.json，恢复前自动备份当前配置
🖥️ 环境检测
自动检测运行环境：
- 操作系统信息（平台、架构、内核、CPU 核心数、内存）
- 软件版本检测（Node.js、Docker、Git、OpenClaw、npm）
- 缺失软件的快速安装指南
其他配置模块
- 身份 & 消息：助手名称、头像、系统提示词、Agent 默认设置
- 通用配置：网关、工具、Hooks、会话、认证密钥、原始 JSON 查看器
- 文档管理：浏览和编辑 OpenClaw 目录下的 Markdown 文档
5. 📋 活动日志
增强版日志系统：
- 按来源筛选（QQ / Bot 回复 / 微信 / 系统）
- 按类型筛选（文本 / 媒体 / 表情）
- 关键词搜索
- 一键导出 JSON
6. ⏰ 定时任务
从 cron/jobs.json 读取真实定时任务，支持 Cron 表达式配置、启用/暂停/删除、运行状态追踪。
🏗️ 技术架构
┌──────────────────────────────────────────────────────┐
│ Docker Compose │
│ │
├──────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────┐ │
│ │ openclaw-qq Container │ │
│ │ ┌─────────┐ ┌──────────┐ ┌───────────┐ │ │
│ │ │ NapCat │ │ClawPanel │ │ Frontend │ │ │
│ │ │ (QQ) │ ←→│ Backend │ ←→│ (React) │ │ │
│ │ │ :6099 │ :6199 │ │ │ │
│ │ └─────────┘ └────┬─────┘ └───────────┘ │ │
│ │ │ │ │
│ └──────────────────┼───────────────────────────────┘ │
│ │ │
│ HTTP callback │ │
│ ┌──────────────────┼───────────────────────────────┐ │
│ │ openclaw-wechat Container │ │
│ │ ┌──────────────────┴──────────────────────┐ │ │
│ │ │ wechatbot-webhook (微信 Web 协议) │ │ │
│ │ └─────────────────────────────────────────┘ │ │
│ └─────────────────────────────────────────────────┘ │
└──────────┬──────────────┬────────────────────────────┘
│ │
┌──────────┴────┐ ┌──────┴──────┐
│ OpenClaw │ │ Browser │
│ Gateway │ │ ClawPanel │
└───────────────┘ └─────────────┘
技术栈：
| 层级 | 技术 |
|---|---|
| QQ 协议 | NapCat (OneBot11 WebSocket) |
| 微信协议 | wechatbot-webhook (Web 微信) |
| 后端 | TypeScript · Express · WebSocket |
| 前端 | React · Vite · TailwindCSS · Lucide Icons |
| AI 引擎 | OpenClaw — 支持 GPT-4o / Claude / Gemini / DeepSeek 等 |
| 部署 | Docker Compose 双容器编排 |
🚀 快速开始
前提条件
- Docker + Docker Compose
- OpenClaw 已安装（https://openclaw.ai）
三步部署
# 1. 克隆项目
git clone https://github.com/zhaoxinyi02/ClawPanel.git
cd ClawPanel
# 2. 配置环境变量
cp .env.example .env
# 编辑 .env，设置 ADMIN_TOKEN（登录密码）、QQ_ACCOUNT 等
# 3. 启动
docker compose up -d
启动后访问 http://你的服务器 IP:6199，输入密码登录即可。
配置 OpenClaw 连接
# Linux / macOS
chmod +x setup-openclaw.sh && ./setup-openclaw.sh
# Windows PowerShell
powershell -ExecutionPolicy Bypass -File setup-openclaw.ps1
📋 版本演进
| 版本 | 日期 | 主要变化 |
|---|---|---|
| v1.0 | 2026-02-08 | 基础管理后台 + NapCat Docker 集成 |
| v2.0 | 2026-02-09 | 全新 React UI，集成 QQ 登录 |
| v3.0 | 2026-02-10 | QQ + 微信双通道，跨平台支持 |
| v4.0 | 2026-02-13 | 品牌升级为 ClawPanel，8 通道 + 技能中心 + 系统配置 |
| v4.1 | 2026-02-14 | 20+ 通道、多模型配置、版本管理、环境检测、文档管理 |
⚠️ 免责声明
本项目仅供学习研究使用，严禁用于任何商业用途。
- 使用第三方客户端登录 QQ/微信可能违反腾讯服务协议，存在封号风险，请使用小号测试
- 本项目作者未进行任何逆向工程，仅做开源项目整合
- 使用者需自行承担一切风险和法律责任
🔗 相关链接
- GitHub：https://github.com/zhaoxinyi02/ClawPanel
- OpenClaw：https://openclaw.ai
- NapCat：https://github.com/NapNeko/NapCatQQ
