zhaoxinyi02/ClawPanel

AI 总结

• 采用 Go 单二进制+React 18 架构，支持 Linux/Windows/macOS 跨平台部署与系统服务化安装。
• 内置 OpenClaw 进程管理、20+消息通道配置（含 QQ/NapCat/微信/Telegram 等）及 WebSocket 实时状态推送。
• 提供插件市场与生命周期管理，支持安装/更新/启停、schema 驱动可视化配置和冲突检测。
• 具备配置自动检测与一键修复、NapCat 掉线自动重连、事件日志 SQLite 持久化等运维能力。
• 支持面板与 OpenClaw 可视化更新（含校验、备份、自动重启），并集成 AI 助手用于故障排查。

内容摘录

<div align="center">

<img src="img/logo.jpg" width="700"/>
ClawPanel

**OpenClaw 智能管理面板 — 单文件部署、跨平台、全功能可视化管理**

Go 单二进制 · React 18 · TailwindCSS · SQLite · WebSocket 实时推送 · 跨平台

License
Version
Go
React
GitHub Stars

快速开始 · 功能特性 · 更新日志 · API 文档 · English

</div>

---
[!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.
[!WARNING]
**macOS，Windows用户** — 目前优先进行 Linux 版本开发和维护，macOS 和 Windows 用户也会逐步跟进，耐心等待～如果 macOS Windows 上遇到 bug，请通过 Issues 反馈，我们会统一处理。感谢理解！
💬 社区交流
欢迎加入 **ClawPanel 官方交流群**，获取最新更新、反馈问题、参与插件开发。
📱 **扫码加入企微群**

<img src="img/wecom.png" width="300"/>

主要功能
智能仪表盘
OpenClaw 进程状态监控（启动/停止/重启）
已启用通道概览、当前模型、运行时间、内存占用
快捷操作：一键重启 OpenClaw / 网关 / ClawPanel / NapCat
通道管理（20+ 通道）
支持 **20+ 种通道**的统一配置和一键启用/禁用：
**内置通道**：QQ (NapCat) · 微信 · Telegram · Discord · WhatsApp · Slack · Signal · Google Chat · BlueBubbles · WebChat
**插件通道**：飞书 · 钉钉 · 企业微信 · QQ 官方 Bot · IRC · Mattermost · Teams · LINE · Matrix · Twitch
**QQ 登录**：扫码 / 快速 / 密码三种方式，支持退出登录和重启 NapCat 容器
**QR 码智能刷新**：自动检测过期二维码，重试获取全新二维码
配置中心
**模型配置**：多提供商管理（OpenAI / Anthropic / Google / DeepSeek / 火山引擎等）
**Agent 配置**：系统提示词、温度、最大 Token 数
**JSON 模式**：直接编辑完整配置 JSON
自动为非 OpenAI 提供商注入 compat.supportsDeveloperRole=false 兼容性修复
技能中心 + 插件管理
技能/插件分离展示，搜索筛选
一键启用/禁用，实时扫描已安装技能（内置 + 工作区 + 应用）
插件中心
**插件市场**：浏览官方/第三方插件列表，按分类筛选（基础、AI 增强、消息处理、娱乐、工具）
**一键操作**：安装 / 卸载 / 更新 / 启用 / 禁用插件，无需重启 OpenClaw
**可视化配置**：自动读取插件 plugin.schema.json，前端动态生成配置表单
**插件日志**：实时查看插件运行日志，便于调试
**多来源安装**：支持从官方仓库、GitHub/Gitee 仓库、本地目录安装
**完善的开发文档**：详细的 插件开发指南、JSON Schema 规范、示例插件
**插件冲突检测**：安装前检查 ID、端口、依赖冲突
配置自动检测 + 一键修复
自动扫描 OpenClaw/NapCat 核心配置文件，检测常见错误
检测项：reportSelfMessage、WS/HTTP 服务状态、端口、Token、模型 API Key 等
前端可视化展示异常项，支持单项修复和「一键修复全部」
修复后自动重启对应进程，配置立即生效
NapCat 掉线自动重连 + 告警
每 30 秒检测 NapCat 连接状态（容器/WS/HTTP/QQ 登录）
连续离线自动重启（Docker 或 Windows 原生进程），可配置重连次数上限
**Windows 原生支持**：Windows 用户安装 NapCat 时自动使用 Shell 版（无需 Docker）
通道管理页面实时状态面板：在线/重连中/登录失效/离线指示灯
手动重连按钮 + 重连日志查看
状态变化通过 WebSocket 实时推送
事件日志
实时消息流：QQ 消息、**Bot 回复**、系统事件
按来源/类型筛选、关键词搜索
SQLite 持久化存储，重启不丢失
外部服务日志接入（POST /api/events）
系统管理
系统环境检测（OS / CPU / Go / OpenClaw 版本）
配置备份与恢复（自动备份当前配置再恢复）
软件安装中心：一键安装 Docker、NapCat、微信机器人等
消息中心：安装任务进度实时追踪
身份文档编辑（IDENTITY.md / USER.md 等）
管理密码修改、版本更新检查
AI 智能助手
内置 AI 对话助手浮窗，支持多提供商/多模型切换，自动使用 OpenClaw 配置的 API。
面板一键自检更新
基于北京服务器国内加速，解决 GitHub 下载不稳定问题
检查更新 → 下载 → SHA256 校验 → 替换程序 → 自动重启，全自动化
**独立更新工具**：更新进程通过 systemd-run --scope 隔离运行，主进程停止后更新不中断
更新成功后弹窗展示版本号和更新内容
自动备份旧程序（.bak），SHA256 校验防损坏
支持离线更新：上传本地二进制文件直接替换
OpenClaw 可视化更新
点击「前往更新」跳转独立更新页面，可视化执行 openclaw update
实时显示更新步骤、进度条、命令输出日志
自动检测当前版本和 npm 最新版本
更新完成后自动发送网关重启信号
❓ 常见问题 & 遇到问题怎么办
[!TIP]
**遇到问题请先在面板中使用 AI 助手（右下角对话图标）提问！** AI 助手已内置完整的 FAQ 知识库，能快速帮你排查和解决问题。

常见问题速查：

| 问题 | 简要解答 |
|:---|:---|
| 安装后 systemctl start 需要密码 | 需要 sudo 权限，输入 **Linux 系统密码**（不是面板密码） |
| 面板默认登录密码 | clawpanel，首次登录后建议修改 |
| 访问面板显示空白 / 无法连接 | 检查服务状态、防火墙放行 19527 端口、云安全组 |
| macOS 安装报错 "无法验证开发者" | 运行 sudo xattr -d com.apple.quarantine /opt/clawpanel/clawpanel |
| 检查更新显示"服务器错误" | 确保服务器能访问 39.102.53.188:16198，检查出站防火墙 |
| OpenClaw 版本显示 unknown | 建议通过 npm 安装：npm i -g openclaw@latest |
| 如何卸载 ClawPanel | sudo systemctl stop clawpanel && sudo rm -rf /opt/clawpanel |

👉 **完整 FAQ 文档**：docs/FAQ.md
架构
技术栈

| 层级 | 技术 |
|:---|:---|
| 后端 | Go 1.22+ · Gin · SQLite (modernc.org/sqlite) · gorilla/websocket · golang-jwt |
| 前端 | React 18 · TypeScript · TailwindCSS · Lucide Icons · Vite |
| 部署 | 单二进制 · go:embed 内嵌前端 · 跨平台静态编译 (CGO_ENABLED=0) |
| AI 引擎 | OpenClaw — 支持 GPT-4o / Claude / Gemini / DeepSeek 等 |
快速开始
跟宝塔面板一样，一条命令搞定安装，自动注册系统服务、开机自启动、配置防火墙。
方式一：一键安装（推荐）

**Linux / macOS**

自动完成：下载二进制 → 安装到 /opt/clawpanel → 注册系统服务 → 开机自启动 → 配置防火墙 → 启动。
完整安装流程请查看在线文档：QQ NapCat个人号安装教程

**Windows（PowerShell 管理员）**
[!NOTE]
安装脚本兼容 **PowerShell 5.1 及以上**版本（Windows 自带版本即可）。脚本会自动从 GitHub 获取最新版本，无需手动指定版本号。

或从 Releases 手动下载 clawpanel-windows-amd64.exe，双击或命令行运行。
方式二：手动下载运行

从 Releases 下载对应平台的二进制文件：

启动后访问 http://localhost:19527，默认密码 clawpanel。
[!WARNING]
手动运行不会注册系统服务，关闭终端后服务会停止。推荐使用一键安装。
方式三：从源码构建
[!TIP]
构建需要 Go 1.22+ 和 Node.js 18+。中国大陆用户请设置：

环境变量

| 变量 | 默认值 | 说明 |
|:---|:---|:---|
| CLAWPANEL_PORT | 19527 | Web 服务端口 |
| CLAWPANEL_DATA | ./data | 数据目录（配置 + 数据库） |
| OPENCLAW_DIR | ~/.openclaw | OpenClaw 配置目录 |
| OPENCLAW_CONFIG | - | OpenClaw 配置文件路径（自动推导目录） |
| OPENCLAW_APP | - | OpenClaw 应用目录（用于技能扫描） |
| OPENCLAW_WORK | - | OpenClaw 工作目录 |
| CLAWPANEL_SECRET | 随机 | JWT 签名密钥 |
| ADMIN_TOKEN | clawpanel | 管理密码 |
| CLAWPANEL_DEBUG | false | 调试模式 |
服务管理
跨平台支持

| 平台 | 架构 | 二进制文件 |
|:---:|:---:|:---|
| Linux | x86_64 | clawpanel-linux-amd64 |
| Linux | ARM64 | clawpanel-linux-arm64 |
| macOS | x86_64 | clawpanel-darwin-amd64 |
| macOS | ARM64 (M1/M2/M3) | clawpanel-darwin-arm64 |
| Windows | x86_64 | clawpanel-windows-amd64.exe |
⚠️ macOS 支持说明：目前开发者暂无 Mac 设备，近期会购入用于测试。macOS 用户遇到问题请提交 Issue。
更新日志

完整更新日志请查看 changelogs/ 目录。
v5.0.24 — 修复 QQ 唤醒配置不生效（Issue #21）
**🐛 修复 QQ 唤醒配置不生效**：修复 wakeProbability、wakeTrigger 等配置仅在面板展示但未落到插件实际生效路径的问题
**✨ 兼容旧配置字段**：后端保存 QQ 通道配置时自动迁移旧字段（wakeProbability/wakeTrigger/minSendIntervalMs/autoApprove*）到新版结构，避免升级后失效
v5.0.14 — 脚本修复 · Windows 兼容性
**🐛 install.ps1 兼容 PowerShell 5.1**：移除三元运算符，Windows 自带 PS 5.1 可直接运行
**✨ 安装脚本自动获取最新版本**：install.sh / install.ps1 启动时自动从 GitHub API 拉取最新版本号，无需随每次发版更新脚本
**🐛 Windows 安装 OpenClaw 不再因缺少 Node.js 退出**：自动通过 winget 安装 Node.js LTS 后继续
v5.0.13 — 修复 QQ 插件强制注入
**🐛 修复 QQ 插件配置强制写入**：仅在 QQ 插件已安装且 NapCat 运行时才注入 channels.qq，避免未使用 QQ 的用户 OpenClaw 网关启动失败
v5.0.12 — OpenClaw 可视化更新 · 版本显示修复
**✨ OpenClaw 可视化更新界面**：实时显示更新步骤、进度条、命令输出日志
**🐛 版本更新页显示旧版本**：GetVersion API 改用 openclaw --version 获取真实版本，不再读取 lastTouchedVersion
**🐛 ClawPanel 版本号显示错误**：版本号改为 ldflags 动态注入，修复硬编码导致显示错误
**✨ OpenClaw 网关 daemon fork 模式检测**：正确识别 daemon fork 启动，防止误判崩溃
v5.0.3 — 插件中心 · Windows NapCat · 跨平台修复
**🧩 插件中心**：全新插件市场页面，支持浏览/安装/卸载/配置/更新/启用/禁用插件
**插件后端**：完整的插件生命周期管理 API（/api/p…