ClawPanel

<div align="center">

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

# ClawPanel

**OpenClaw 智能管理面板 — 现已提供 Pro / Lite 双发行形态，覆盖纯面板接管与开箱即用托管运行时**

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

[![License](https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-red?style=flat-square)](LICENSE)
[![Pro](https://img.shields.io/badge/Pro-5.2.8-violet?style=flat-square)](https://github.com/zhaoxinyi02/ClawPanel/releases)
[![Lite](https://img.shields.io/badge/Lite-0.1.6-2563eb?style=flat-square)](https://github.com/zhaoxinyi02/ClawPanel/releases)
[![Go](https://img.shields.io/badge/go-1.22+-00ADD8?style=flat-square&logo=go&logoColor=white)](https://go.dev)
[![React](https://img.shields.io/badge/react-18-61DAFB?style=flat-square&logo=react&logoColor=white)](https://react.dev)
[![CI](https://github.com/zhaoxinyi02/ClawPanel/actions/workflows/ci.yml/badge.svg)](https://github.com/zhaoxinyi02/ClawPanel/actions/workflows/ci.yml)
[![Release Build](https://github.com/zhaoxinyi02/ClawPanel/actions/workflows/release.yml/badge.svg)](https://github.com/zhaoxinyi02/ClawPanel/actions/workflows/release.yml)
[![GitHub Stars](https://img.shields.io/github/stars/zhaoxinyi02/ClawPanel?style=flat-square&logo=github)](https://github.com/zhaoxinyi02/ClawPanel/stargazers)

[快速开始](#-快速开始) · [功能特性](#-主要功能) · [更新日志](changelogs/) · [API 文档](docs/API.md) · [English](README_EN.md)

</div>

---

> [!CAUTION]
> **免责声明 | Disclaimer**
>
> 本项目仅供**学习研究**使用，**严禁用于任何商业用途**。使用第三方客户端登录 QQ/微信可能违反腾讯服务协议，**存在封号风险**，请使用小号测试。本项目作者**未进行任何逆向工程**，仅做开源项目整合，**不对任何后果承担责任**。下载使用即表示同意 [完整免责声明](DISCLAIMER.md)。
>
> This project is for **learning and research purposes only**. **Commercial use is strictly prohibited.** Use at your own risk. See [full disclaimer](DISCLAIMER.md).

> [!NOTE]
> **最新 Pro / Lite 更新** — `ClawPanel Pro v5.2.8` 补强 macOS OpenClaw 探测、受管工作区兼容与 MiniMax 默认配置；`ClawPanel Lite v0.1.6` 修复 Windows / macOS Lite 误探测本机外部 `openclaw` 的问题，并新增“只卸载本机外部 OpenClaw、不影响 Lite 内嵌运行时”的说明。详见 [changelogs/v5.2.8.md](changelogs/v5.2.8.md) 和 [changelogs/lite-v0.1.6.md](changelogs/lite-v0.1.6.md)

### 💬 社区交流
欢迎加入 **ClawPanel 官方交流群**，获取最新更新、反馈问题、参与插件开发。

> 📱 **扫码加入企微群**
> 
> <img src="img/wecom.jpg" width="300"/>
> 



## 主要功能

### Lite / Pro 对比

| 维度 | ClawPanel Lite | ClawPanel Pro |
|:---|:---|:---|
| 目标用户 | 新手 / 想开箱即用 | 已有 OpenClaw 环境的进阶用户 |
| OpenClaw | 内置 `2026.2.26`，安装后直接可用 | 不内置，支持一键安装或外部接管 |
| 运行时控制 | 面板全托管 | 用户可自行决定 |
| 通道插件 | 常用插件预置好，默认关闭可直接配置 | 按需安装、按需接管 |
| 外部 OpenClaw | 不支持 | 支持 |
| 更新 | 跟随 Lite 独立版本线 | 跟随 Pro 独立版本线 |
| Linux | 已可用 | 已可用 |
| Windows / macOS | 已可用 | 已可用 |

### Workflow Center 1.0（v5.2.1 重点更新）
- 工作流设置、模板 CRUD、AI 生成模板、运行列表、步骤详情、事件流与删除实例
- 支持复杂任务自动接管原会话：即时确认、进度回写、暂停 / 恢复 / 重试 / 审批 / 继续
- 节点支持 `input / wait_user / approval / ai_plan / ai_task / analyze / summary / publish / end`
- 节点支持 `skill` 参数，可自动加载 `SKILL.md` 参与执行
- 关键步骤结果自动落文件到 OpenClaw 工作区，并在工作流详情页显示产出文件、回传状态、失败原因
- QQ 私聊 / 群聊支持工作流完成后自动回传最终文件，支持预览、下载、单文件重发与批量重发最终文件

### 多智能体控制台（v5.1.x 重点更新）
- Agent 列表管理：新建 / 编辑 / 删除，支持默认 Agent 设置
- `Core Files`：可直接查看和保存 Agent 工作区核心文件
- `Skills · Channels · Cron`：从单 Agent 视角查看技能、通道和定时任务快照
- `Recent Sessions`：快速巡检当前 Agent 最近活跃会话
- Bindings 路由规则管理：支持**结构化表单 + JSON 高级模式**，可启停、重排和规则级错误定位
- 路由预览器：输入 `channel/sender/peer/parentPeer/guildId/teamId/accountId/roles` 快速验证命中 Agent

### 智能仪表盘
- 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 数
- **浏览器控制预设**：可视化切换 `browser.enabled=false` 与 `browser.enabled=true + browser.defaultProfile="openclaw"`，降低误接管系统浏览器的风险
- **JSON 模式**：直接编辑完整配置 JSON（保存前差异预览）
- 自动为非 OpenAI 提供商注入 `compat.supportsDeveloperRole=false` 兼容性修复
- `openclaw.json` 写入前自动快照备份（`backups/pre-edit-*.json`）

### 技能中心 + 插件管理
- 技能/插件分离展示，搜索筛选
- 一键启用/禁用，实时扫描已安装技能（内置 + 工作区 + 应用）

### 插件中心
- **插件市场**：浏览官方/第三方插件列表，按分类筛选（基础、AI 增强、消息处理、娱乐、工具）
- **一键操作**：安装 / 卸载 / 更新 / 启用 / 禁用插件，无需重启 OpenClaw
- **可视化配置**：自动读取插件 `plugin.schema.json`，前端动态生成配置表单
- **插件日志**：实时查看插件运行日志，便于调试
- **多来源安装**：支持从官方仓库、GitHub/Gitee 仓库、本地目录安装
- **完善的开发文档**：详细的 [插件开发指南](docs/plugin-dev/README.md)、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 回复**、系统事件
- 按来源/类型筛选、关键词搜索
-

... (truncated)