zhaoxinyi02 / ClawPanel

ClawPanel **OpenClaw 智能管理面板 — 现已提供 Pro / Lite 双发行形态，覆盖纯面板接管与开箱即用托管运行时** Go 单二进制 · React 18 · TailwindCSS · SQLite · WebSocket 实时推送 · 跨平台 快速开始 · 功能特性 · 更新日志 · 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] > **最新发布** — 与 已发布；若一键安装/手动更新没有拿到最新版，请优先重新拉取安装脚本或检查加速服务器元数据是否已同步。 💬 社区交流 欢迎加入 **ClawPanel 官方交流群**，获取最新更新、反馈问题、参与插件开发。 > 📱 **扫码加入企微群** > > > 主要功能 Lite / Pro 对比 | 维度 | ClawPanel Lite | ClawPanel Pro | |:---|:---|:---| | 目标用户 | 新手 / 想开箱即用 | 已有 OpenClaw 环境的进阶用户 | | OpenClaw | 内置 ，安装后直接可用 | 不内置，支持一键安装或外部接管 | | 运行时控制 | 面板全托管 | 用户可自行决定 | | 通道插件 | 常用插件预置好，默认关闭可直接配置 | 按需安装、按需接管 | | 外部 OpenClaw | 不支持 | 支持 | | 更新 | 跟随 Lite 独立版本线 | 跟随 Pro 独立版本线 | | Linux | 已可用 | 已可用 | | macOS | 预览阶段 | 已可用 | | Windows | 暂不提供（整包超 2GB 限制，请使用 Pro） | 已可用 | Workflow Center 1.0（v5.2.1 重点更新） • 工作流设置、模板 CRUD、AI 生成模板、运行列表、步骤详情、事件流与删除实例 • 支持复杂任务自动接管原会话：即时确认、进度回写、暂停 / 恢复 / 重试 / 审批 / 继续 • 节点支持 • 节点支持 参数，可自动加载 参与执行 • 关键步骤结果自动落文件到 OpenClaw 工作区，并在工作流详情页显示产出文件、回传状态、失败原因 • QQ 私聊 / 群聊支持工作流完成后自动回传最终文件，支持预览、下载、单文件重发与批量重发最终文件 多智能体控制台（v5.1.x 重点更新） • Agent 列表管理：新建 / 编辑 / 删除，支持默认 Agent 设置 • ：可直接查看和保存 Agent 工作区核心文件 • ：从单 Agent 视角查看技能、通道和定时任务快照 • ：快速巡检当前 Agent 最近活跃会话 • Bindings 路由规则管理：支持**结构化表单 + JSON 高级模式**，可启停、重排和规则级错误定位 • 路由预览器：输入 快速验证命中 Agent 编排监控台（Monitor） • **全局拓扑图**：基于 React Flow 的 DAG 可视化，一眼看清所有通道、智能体和路由关系 • Channel → Agent 绑定路由、Agent → Agent 子代理调用、未绑定通道 → 默认代理回退，三类连线一目了然 • 点击节点/边查看详细配置：Agent 身份/模型/工具/沙箱，Channel 状态/关联 Agent，Binding 匹配条件/优先级 • 顶部指标栏：Agent 数、通道数、绑定数、会话总数实时统计 • 底部状态卡片：每个 Agent 的会话数、最后活跃时间、在线状态 • dagre 自动分层布局 + 手动拖拽调整，支持缩放/平移/小地图 • 手动刷新触发渲染，支持暗色模式和中英双语 智能仪表盘 • 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 提供商注入 兼容性修复 • 写入前自动快照备份（ ） 技能中心 + 插件管理 • 技能/插件分离展示，搜索筛选 • 一键启用/禁用，实时扫描已安装技能（内置 + 工作区 + 应用） 插件中心 • **插件市场**：浏览官方/第三方插件列表，按分类筛选（基础、AI 增强、消息处理、娱乐、工具） • **一键操作**：安装 / 卸载 / 更新 / 启用 / 禁用插件，无需重启 OpenClaw • **可视化配置**：自动读取插件 ，前端动态生成配置表单 • **插件日志**：实时查看插件运行日志，便于调试 • **多来源安装**：支持从 GitHub、Gitee 脚本入口、本地目录安装，并根据区域在线选择 GitHub 或香港加速服务器下载构建包 • **完善的开发文档**：详细的 插件开发指南、JSON Schema 规范、示例插件 • **插件冲突检测**：安装前检查 ID、端口、依赖冲突 配置自动检测 + 一键修复 • 自动扫描 OpenClaw/NapCat 核心配置文件，检测常见错误 • 检测项： 、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 校验 → 替换程序 → 自动重启，全自动化 • **独立更新工具**：更新进程通过 隔离运行，主进程停止后更新不中断 • 更新成功后弹窗展示版本号和更新内容 • 自动备份旧程序（ ），SHA256 校验防损坏 • 支持离线更新：上传本地二进制文件直接替换 OpenClaw 可视化更新 • 点击「前往更新」跳转独立更新页面，可视化执行 • 实时显示更新步骤、进度条、命令输出日志 • 自动检测当前版本和 npm 最新版本 • 更新完成后自动发送网关重启信号 ❓ 常见问题 & 遇到问题怎么办 > [!TIP] > **遇到问题请先在面板中使用 AI 助手（右下角对话图标）提问！** AI 助手已内置完整的 FAQ 知识库，能快速帮你排查和解决问题。 常见问题速查： | 问题 | 简要解答 | |:---|:---| | 安装后 需要密码 | 需要 sudo 权限，输入 **Linux 系统密码**（不是面板密码） | | 面板默认登录密码 | ，首次登录后建议修改 | | 访问面板显示空白 / 无法连接 | 检查服务状态、防火墙放行 19527 端口、云安全组 | | macOS 安装报错 "无法验证开发者" | 运行 | | 检查更新显示"服务器错误" | 优先确认服务器能访问 GitHub；国内线路也可改走香港加速服务器，检查出站防火墙 | | Browser 在哪里配置 | 面板内进入 ，可直接管理 与 | | Windows + WSL 的 OpenClaw 能否给 Pro 用 | 可以，但推荐把 WSL 内的 OpenClaw 当作“外部网关”接入；不要指望 Windows 面板直接双击拉起 WSL 里的 Linux OpenClaw | | OpenClaw 版本显示 unknown | 建议通过 npm 安装： | | 如何卸载 ClawPanel | | 👉 **完整 FAQ 文档**：docs/FAQ.md 架构 技术栈 | 层级 | 技术 | |:---|:---| | 后端 | Go 1.22+ · Gin · SQLite (modernc.org/sqlite) · gorilla/websocket · golang-jwt | | 前端 | React 18 · TypeScript · TailwindCSS · Lucide Icons · Vite | | 部署 | 单二进制 · 内嵌前端 · 跨平台静态编译 ( ) | | AI 引擎 | OpenClaw — 支持 GPT-4o / Claude / Gemini / DeepSeek 等 | 快速开始 > 跟宝塔面板一样，一条命令搞定安装，自动注册系统服务、开机自启动、配置防火墙。 方式一：一键安装（推荐） **ClawPanel Lite（Linux，现已可用）** 自动完成：下载 Lite Core → 安装到 → 注册 服务 → 启动内置 OpenClaw。 **ClawPanel Lite（macOS，预览阶段）** 说明：当前提供 预览包，建议先在测试环境验证。安装后如遇“无法验证开发者”提示，可执行 。 **ClawPanel Pro（Linux / macOS）** 自动完成：下载二进制 → 安装到 → 注册系统服务 → 开机自启动 → 配置防火墙 → 启动。 完整安装流程请查看在线文档：QQ NapCat个人号安装教程 **Windows（PowerShell 管理员，当前为 Pro 发行形态）** > [!NOTE] > 安装脚本兼容 **PowerShell 5.1 及以上**版本（Windows 自带版本即可）。脚本会自动从 GitHub 获取最新版本，无需手动指定版本号。 或从 Releases 手动下载对应版本的 ，双击或命令行运行。 手动更新（面板内更新失败时使用） > [!IMPORTANT] > **Windows + WSL 使用 Pro 的推荐方式**：先在 WSL 内自行启动 ，再在 ClawPanel 中把网关模式切到 指向 WSL 暴露的网关地址。当前不建议把 Windows 面板进程直接当成 WSL 内 Linux OpenClaw 的拉起器。 > [!TIP] > 正常情况下在面板内「系统配置 → 检查更新」即可一键更新。如果你的服务器之前使用旧加速服务器导致更新失败，可运行以下命令手动更新到最新版本，更新后面板内更新功能将恢复正常。 **ClawPanel Pro（Linux / macOS）** **ClawPanel Lite（Linux）** > 脚本会自动：检测当前版本 → 从加速服务器下载最新版（失败自动切 GitHub）→ 停服 → 替换二进制 → 重启服务 → 验证启动。更新失败时自动回滚。 一键卸载 **ClawPanel Lite（Linux）** **ClawPanel Lite（macOS）** **ClawPanel Pro（Linux）** **ClawPanel Pro（macOS）** **ClawPanel Pro（Windows）** 卸载本机外部 OpenClaw（不影响 Lite 内嵌运行时） 以下命令用于清理你系统里**单独安装**的 （例如 npm 全局安装、用户目录下的 / ），**不会删除** Lite 自己安装目录中的内嵌运行时（ ）。 **Linux / macOS**…