Skip to content

mis007/ClawPanel

 
 

Repository files navigation

🐾 ClawPanel

OpenClaw 智能管理面板 — 比官方控制台更强大的可视化管理工具

多通道接入 · 多模型配置 · 技能中心 · 版本管理 · 环境检测 · Docker 一键部署

License Docker Version GitHub Stars

快速开始 · 功能特性 · 效果预览 · API 文档 · 部署指南 · English


Caution

⚠️ 免责声明 | Disclaimer

本项目仅供学习研究使用,严禁用于任何商业用途。使用第三方客户端登录 QQ/微信可能违反腾讯服务协议,存在封号风险,请使用小号测试。本项目作者未进行任何逆向工程,仅做开源项目整合,不对任何后果承担责任。下载使用即表示同意 完整免责声明

This project is for learning and research purposes only. Commercial use is strictly prohibited. Use at your own risk. See full disclaimer.

Note

v4.2.1 UI 美化 & 通道修复:全新紫罗兰主题设计、专业图标替换、仪表盘/侧边栏显示所有已连接通道、网关重启成功日志、favicon 更新。 旧版本请查看 v3.0.0 Tag

✨ 主要功能

📊 智能仪表盘

动态展示已连接通道卡片、AI 模型状态、运行时间、内存占用、今日消息统计、最近活动流。仅显示已连接的通道,未连接的通道不再占位。

📋 活动日志

增强版日志系统:按来源筛选(QQ / Bot回复 / 微信 / 系统)、按类型筛选(文本 / 媒体 / 表情)、关键词搜索、一键导出 JSON。

📡 通道管理(20+ 通道)

支持 20+ 种通道的统一配置,分为内置通道和插件通道两大类:

内置通道:

  • QQ (NapCat) — 扫码/快速/账密登录,唤醒概率、触发词、戳一戳回复、QQ 审核请求集成
  • 微信 — 扫码登录,基于 wechatbot-webhook
  • Telegram — Bot Token + Webhook
  • Discord — Bot Token + Guild 配置
  • WhatsApp — QR 扫码
  • Slack — Socket Mode
  • Signal — signal-cli REST API
  • Google Chat — 服务账号 + Webhook

插件通道:

  • 飞书 / Lark · 钉钉 · 企业微信 · QQ 官方 Bot · IRC · Mattermost · Microsoft Teams · LINE · Matrix · Twitch · BlueBubbles · WebChat

已连接的通道自动置顶显示,QQ 审核请求直接集成在 QQ 通道配置页面中。

⚡ 技能中心 + ClawHub 商店

  • 已安装技能:从服务端实时扫描,一键启用/禁用,搜索筛选
  • ClawHub 商店:浏览 13+ 可安装技能,一键获取安装命令(这里暂时没有完善,爬取ClawHub不完全,下个版本完善)

⏰ 定时任务

cron/jobs.json 读取真实定时任务:Cron 表达式配置、启用/暂停/删除、运行状态追踪、消息内容编辑。

⚙️ 系统配置(6 大模块)

全新 6 标签页深度配置:

🧠 模型配置

多模型提供商管理,支持 8+ 主流 AI 厂商一键填充:

  • OpenAI · Anthropic · Google · DeepSeek · NVIDIA NIM · Groq · Together AI · OpenRouter
  • 每个提供商可配置 Base URL、API Key、API 类型、模型列表
  • 快捷添加已知模型(GPT-4o、Claude Sonnet 4.5、Gemini 2.0 等)

👤 身份 & 消息

助手名称、头像、主题色、系统提示词、历史消息数、Agent 默认设置(上下文Token、最大输出、并发数、压缩模式)。

🔧 通用配置

网关配置、工具配置(媒体理解/网页搜索)、Hooks、会话配置(自动压缩/修剪)、认证密钥(API Keys)、原始 JSON 查看器。

📦 版本管理

  • 当前版本 / 最新版本对比
  • 更新检测与提示
  • 配置备份与恢复:一键备份 openclaw.json,恢复前自动备份当前配置

🖥️ 环境检测

自动检测运行环境:

  • 操作系统信息(平台、架构、内核、CPU、内存)
  • 软件版本检测(Node.js、Docker、Git、OpenClaw、npm)
  • 快速安装指南

📄 文档管理

浏览和编辑 OpenClaw 目录下的 Markdown 文档,内置编辑器,一键保存。

📁 工作区

文件浏览器:查看、编辑、创建 OpenClaw 工作区文件。

🏗️ 架构

┌──────────────────────────────────────────────────────┐
│                  Docker Compose                      │
│                                                      │
│  ┌─────────────────────────────────────────────────┐ │
│  │          openclaw-qq Container                  │ │
│  │  ┌─────────┐  ┌──────────┐  ┌───────────┐      │ │
│  │  │ NapCat  │  │ClawPanel │  │ Frontend  │      │ │
│  │  │  (QQ)   │←→│ Backend  │←→│ (React)   │      │ │
│  │  │  :6099  │  │  :6199   │  │           │      │ │
│  │  └─────────┘  └────┬─────┘  └───────────┘      │ │
│  └─────────────────────┼───────────────────────────┘ │
│                        │ HTTP callback               │
│  ┌─────────────────────┼───────────────────────────┐ │
│  │     openclaw-wechat Container                   │ │
│  │  ┌──────────────────┴──────────────────────┐    │ │
│  │  │   wechatbot-webhook (微信 Web 协议)      │    │ │
│  │  │   :3001 (内部) → :3002 (外部)            │    │ │
│  │  └─────────────────────────────────────────┘    │ │
│  └─────────────────────────────────────────────────┘ │
└──────────┬──────────────┬────────────────────────────┘
           │              │
      ┌────┴────┐    ┌────┴────┐
      │ 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 双容器编排

🚀 快速开始

前提条件

1️⃣ 克隆 & 配置

git clone https://github.com/zhaoxinyi02/ClawPanel.git
cd ClawPanel
cp .env.example .env

编辑 .env

ADMIN_TOKEN=你的管理密码        # ClawPanel 登录密码
QQ_ACCOUNT=你的QQ号            # QQ 账号(可选,用于快速登录)
OWNER_QQ=主人QQ号              # 接收通知的 QQ 号
WECHAT_TOKEN=openclaw-wechat   # 微信 Webhook Token
OPENCLAW_DIR=~/.openclaw       # OpenClaw 配置目录

2️⃣ 启动

docker compose up -d

3️⃣ 配置 OpenClaw 频道

# Linux / macOS
chmod +x setup-openclaw.sh && ./setup-openclaw.sh

# Windows PowerShell
powershell -ExecutionPolicy Bypass -File setup-openclaw.ps1

4️⃣ 登录 & 使用

  1. 浏览器访问 http://你的服务器IP:6199
  2. 输入 ADMIN_TOKEN 登录
  3. 左侧 「通道管理」 → 选择 QQ → 扫码登录
  4. 左侧 「通道管理」 → 选择微信 → 扫码登录
  5. 用另一个号给 Bot 发消息,收到 AI 回复即成功 🎉

📡 端口说明

端口 服务 说明
6199 ClawPanel 主入口,浏览器访问
6099 NapCat WebUI QQ 协议管理(可选)
3001 OneBot11 WS OpenClaw 连接 QQ 用
3002 微信 Webhook 微信 API 调试用

🌍 跨平台部署

平台 启动命令 配置脚本
🐧 Linux docker compose up -d ./setup-openclaw.sh
🍎 macOS docker compose up -d ./setup-openclaw.sh
🪟 Windows docker compose up -d powershell -File setup-openclaw.ps1

Tip

Windows 用户需在 .env 中设置 OPENCLAW_DIR=C:\Users\你的用户名\.openclaw

📖 文档

文档 说明
API 接口文档 完整的 REST API + WebSocket 接口说明
部署指南 详细部署步骤、环境变量、防火墙、反向代理、故障排查

❓ 常见问题

QQ 扫码后提示登录失败?

确保 QQ 账号没有开启设备锁,或尝试使用快速登录。

微信扫码页面打不开?

确保微信容器已启动:docker compose logs wechat,且端口 3002 未被占用。

微信提示不支持网页版登录?

部分微信账号未开通网页版权限,需要使用较早注册的微信号。

OpenClaw 连接不上?

运行 ./setup-openclaw.sh 重新配置,然后重启 OpenClaw。

如何查看日志?
docker compose logs -f          # 全部日志
docker compose logs -f wechat   # 仅微信容器
如何更新到最新版?
git pull && docker compose up -d --build

📋 更新日志

v4.2.1 — UI 美化 & 通道显示修复 (2026-02-17)

  • 🎨 全新紫罗兰主题:统一的 Violet 色调设计,现代化卡片布局,深色/浅色模式全面适配
  • 🎨 专业图标:全面替换 emoji 为 Lucide 专业图标库
  • 🔧 仪表盘通道修复:显示所有已启用通道(QQ/飞书/QQBot/钉钉等),不再仅显示 QQ 和微信
  • 🔧 侧边栏通道修复:运行状态区显示所有已启用通道,QQ 号码完整显示不再截断
  • 🔧 网关重启日志:通道启用/禁用后自动轮询网关重启结果,记录成功/失败日志
  • 🔧 移除 QQ 群/好友卡片:仪表盘不再显示冗余的 QQ 群/好友统计卡片
  • 🆕 Favicon 更新:浏览器标签页图标更换为 ClawPanel Logo
  • 🆕 Apple Touch Icon:添加 iOS 主屏幕图标支持
  • 📝 英文 README:新增 README_EN.md,方便国际用户阅读

v4.2.0 — 通道管理增强 & Bug 修复 (2026-02-16)

  • 🔧 QQ 登录修复:扫码登录、快速登录、账密登录按钮全部可用,二维码正常显示
  • 🔧 通道开关修复:关闭通道后 OpenClaw 网关自动重启,配置即时生效
  • 🔧 QQ 退出登录:关闭 QQ 通道时自动退出 QQ 登录(清除会话数据),重新开启需扫码
  • 🔧 WeChat 配置兼容:修复 channels.wechat: unknown channel id 错误(#9),微信配置不再写入 openclaw.json
  • 🔧 tools/session 兼容:修复 OpenClaw 2026.2.14+ 不支持 tools/session 顶层键导致的配置报错(#10)
  • 🔧 通知开关:QQ 通道配置中新增防撤回、成员变动、管理员变动、禁言、戳一戳、荣誉等通知开关
  • 🆕 活跃通道状态:仪表盘和侧边栏根据通道启用状态 + 连接状态动态显示,关闭的通道不再显示为活跃
  • 🆕 活动日志增强:通道开启/关闭、QQ 登录/退出、网关重启等操作自动记录系统日志
  • 🆕 QQ 未登录状态:QQ 通道启用但未登录时显示占位信息和登录按钮
  • 🆕 退出登录按钮:QQ 通道新增「退出登录」按钮,一键退出 QQ 账号
  • 🆕 环境检测增强:准确检测宿主机 OS 版本、Docker/Git/Bun 版本
  • 🆕 一键更新:版本管理支持一键更新 OpenClaw,显示更新进度
  • 🔧 定时任务修复:修复定时任务无法删除的问题
  • 🔧 autoSetup 修复:容器重启不再覆盖用户手动禁用的 QQ 通道配置

v4.1.0 — 全面功能扩展 (2026-02-14)

  • 🆕 通道管理:新增 20+ 通道支持(飞书/钉钉/企业微信/QQ官方Bot/IRC/Teams/LINE/Matrix/Twitch 等)
  • 🆕 通道管理:已连接通道自动置顶,QQ 审核请求集成到 QQ 通道页面
  • 🆕 技能中心:从服务端实时扫描已安装插件,ClawHub 商店列出 13+ 可安装技能
  • 🆕 系统配置:全新 6 标签页(模型/身份消息/通用/版本/环境/文档)
  • 🆕 多模型配置:支持 8+ AI 厂商(OpenAI/Anthropic/Google/DeepSeek/Groq/OpenRouter 等)
  • 🆕 版本管理:当前版本/最新版本对比、配置备份与恢复
  • 🆕 环境检测:自动检测 OS/软件版本,提供安装指南
  • 🆕 文档管理:浏览和编辑 OpenClaw 目录下的 MD 文档
  • 🆕 定时任务:从 cron/jobs.json 读取真实任务数据
  • 🆕 新增 API/system/env/system/version/system/backup/system/skills 等 10 个端点
  • 🧹 清理废弃页面(QQ.tsx/QQBot.tsx/QQLogin.tsx/WeChatLogin.tsx/Settings.tsx/OpenClawConfig.tsx/Requests.tsx)
  • 🧹 清理测试脚本和旧截图

v4.0.0 — ClawPanel 智能管理面板 (2026-02-13)

  • 🆕 全新品牌:从 openclaw-im-manager 升级为 ClawPanel
  • 🆕 仪表盘:活跃通道、AI 模型、运行时间、内存、今日消息统计
  • 🆕 活动日志:来源/类型筛选、关键词搜索、日志导出
  • 🆕 通道管理:8 种通道统一配置(QQ/TG/Discord/微信/WhatsApp/Slack/Signal/Google Chat)
  • 🆕 技能中心:技能列表、启用/禁用、ClawHub 商店入口
  • 🆕 定时任务:创建/编辑/删除/暂停、Cron 表达式、运行状态
  • 🆕 系统配置:9 大分组可视化编辑(模型/身份/消息/工具/网关/Hooks/会话/浏览器/密钥)
  • 🎨 全新 UI:紫色渐变品牌、导航分组、深色/浅色主题

v3.0.0 — QQ + 微信双通道 (2026-02-10)

  • 🆕 新增微信个人号接入(基于 wechatbot-webhook)
  • 🆕 管理后台新增微信登录页面、微信状态显示
  • 🆕 仪表盘支持 QQ + 微信双通道实时事件
  • 🌍 跨平台支持(Linux / macOS / Windows)
  • 📝 项目更名:openclaw-qq-pluginopenclaw-im-manager

v2.0.0 — 全新管理后台 (2026-02-09)

  • 💻 全新管理后台 UI(React + TailwindCSS)
  • 🔐 集成 QQ 登录(扫码 / 快速 / 账密)
  • 🔌 内置 OneBot WS 代理
  • 💾 QQ 登录 session 持久化

v1.0.0 — 初始版本

  • 🐳 基础管理后台 + NapCat Docker 集成

❤️ 致谢

本项目的实现离不开以下优秀的开源项目:

⚠️ 免责声明

本项目仅供学习研究使用,严禁商用。

  • 🚫 严禁商用 — 不得用于任何商业目的、付费服务、收费机器人等
  • ⚠️ 封号风险 — 使用第三方客户端登录 QQ/微信可能导致账号被封禁
  • 🔒 无逆向 — 本项目未进行任何逆向工程,仅整合已有开源项目
  • 📋 自担风险 — 使用者需自行承担一切风险和法律责任
  • 💰 作者未盈利 — 本项目作者未从中获取任何经济收益

详细免责声明请阅读 DISCLAIMER.md

📄 License

CC BY-NC-SA 4.0 © 2026 — 禁止商用

本项目采用 知识共享 署名-非商业性使用-相同方式共享 4.0 国际许可证 进行许可。

About

🐾 ClawPanel — OpenClaw 智能管理面板 | 20+ 通道接入(QQ/微信/Telegram/Discord/飞书/钉钉…)· 多模型配置 · 技能中心 · 定时任务 · 版本管理 · 环境检测 · Docker 一键部署

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 95.8%
  • Shell 2.0%
  • PowerShell 1.2%
  • HTML 0.3%
  • CSS 0.3%
  • Dockerfile 0.2%
  • JavaScript 0.2%