Caution
本项目仅供学习研究使用,严禁用于任何商业用途。使用第三方客户端登录 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+ 种通道的统一配置,分为内置通道和插件通道两大类:
内置通道:
- 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 商店:浏览 13+ 可安装技能,一键获取安装命令(这里暂时没有完善,爬取ClawHub不完全,下个版本完善)
从 cron/jobs.json 读取真实定时任务:Cron 表达式配置、启用/暂停/删除、运行状态追踪、消息内容编辑。
全新 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 双容器编排 |
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 配置目录docker compose up -d# Linux / macOS
chmod +x setup-openclaw.sh && ./setup-openclaw.sh
# Windows PowerShell
powershell -ExecutionPolicy Bypass -File setup-openclaw.ps1- 浏览器访问
http://你的服务器IP:6199 - 输入
ADMIN_TOKEN登录 - 左侧 「通道管理」 → 选择 QQ → 扫码登录
- 左侧 「通道管理」 → 选择微信 → 扫码登录
- 用另一个号给 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- 🎨 全新紫罗兰主题:统一的 Violet 色调设计,现代化卡片布局,深色/浅色模式全面适配
- 🎨 专业图标:全面替换 emoji 为 Lucide 专业图标库
- 🔧 仪表盘通道修复:显示所有已启用通道(QQ/飞书/QQBot/钉钉等),不再仅显示 QQ 和微信
- 🔧 侧边栏通道修复:运行状态区显示所有已启用通道,QQ 号码完整显示不再截断
- 🔧 网关重启日志:通道启用/禁用后自动轮询网关重启结果,记录成功/失败日志
- 🔧 移除 QQ 群/好友卡片:仪表盘不再显示冗余的 QQ 群/好友统计卡片
- 🆕 Favicon 更新:浏览器标签页图标更换为 ClawPanel Logo
- 🆕 Apple Touch Icon:添加 iOS 主屏幕图标支持
- 📝 英文 README:新增 README_EN.md,方便国际用户阅读
- 🔧 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 通道配置
- 🆕 通道管理:新增 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)
- 🧹 清理测试脚本和旧截图
- 🆕 全新品牌:从
openclaw-im-manager升级为 ClawPanel - 🆕 仪表盘:活跃通道、AI 模型、运行时间、内存、今日消息统计
- 🆕 活动日志:来源/类型筛选、关键词搜索、日志导出
- 🆕 通道管理:8 种通道统一配置(QQ/TG/Discord/微信/WhatsApp/Slack/Signal/Google Chat)
- 🆕 技能中心:技能列表、启用/禁用、ClawHub 商店入口
- 🆕 定时任务:创建/编辑/删除/暂停、Cron 表达式、运行状态
- 🆕 系统配置:9 大分组可视化编辑(模型/身份/消息/工具/网关/Hooks/会话/浏览器/密钥)
- 🎨 全新 UI:紫色渐变品牌、导航分组、深色/浅色主题
- 🆕 新增微信个人号接入(基于 wechatbot-webhook)
- 🆕 管理后台新增微信登录页面、微信状态显示
- 🆕 仪表盘支持 QQ + 微信双通道实时事件
- 🌍 跨平台支持(Linux / macOS / Windows)
- 📝 项目更名:
openclaw-qq-plugin→openclaw-im-manager
- 💻 全新管理后台 UI(React + TailwindCSS)
- 🔐 集成 QQ 登录(扫码 / 快速 / 账密)
- 🔌 内置 OneBot WS 代理
- 💾 QQ 登录 session 持久化
- 🐳 基础管理后台 + NapCat Docker 集成
本项目的实现离不开以下优秀的开源项目:
- NapNeko/NapCatQQ — QQ 协议框架
- danni-cool/wechatbot-webhook — 微信 Webhook 机器人
- OpenClaw — AI 助手引擎
本项目仅供学习研究使用,严禁商用。
- 🚫 严禁商用 — 不得用于任何商业目的、付费服务、收费机器人等
⚠️ 封号风险 — 使用第三方客户端登录 QQ/微信可能导致账号被封禁- 🔒 无逆向 — 本项目未进行任何逆向工程,仅整合已有开源项目
- 📋 自担风险 — 使用者需自行承担一切风险和法律责任
- 💰 作者未盈利 — 本项目作者未从中获取任何经济收益
详细免责声明请阅读 DISCLAIMER.md
CC BY-NC-SA 4.0 © 2026 — 禁止商用
本项目采用 知识共享 署名-非商业性使用-相同方式共享 4.0 国际许可证 进行许可。









