ClawPanel

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

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

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

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

📱 扫码加入企微群

• OpenClaw 进程状态监控（启动/停止/重启）
• 已启用通道概览、当前模型、运行时间、内存占用
• 快捷操作：一键重启 OpenClaw / 网关 / ClawPanel / NapCat

支持 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 等
• 前端可视化展示异常项，支持单项修复和「一键修复全部」
• 修复后自动重启对应进程，配置立即生效

• 每 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 对话助手浮窗，支持多提供商/多模型切换，自动使用 OpenClaw 配置的 API。

• 基于北京服务器国内加速，解决 GitHub 下载不稳定问题
• 检查更新 → 下载 → SHA256 校验 → 替换程序 → 自动重启，全自动化
• 更新成功后弹窗展示版本号和更新内容
• 自动备份旧程序（.bak），SHA256 校验防损坏

常见问题速查：

👉 完整 FAQ 文档：docs/FAQ.md

┌──────────────────────────────────────────────┐
│            ClawPanel (单二进制)                │
│                                              │
│  ┌───────────┐  ┌────────────┐  ┌─────────┐ │
│  │  Go 后端  │  │ React 前端 │  │ SQLite  │ │
│  │  (Gin)    │←→│ (go:embed) │  │   DB    │ │
│  │  :19527   │  │            │  │         │ │
│  └─────┬─────┘  └────────────┘  └─────────┘ │
│        │                                     │
│  ┌─────┴──────┐  ┌────────────┐             │
│  │  Process   │  │ WebSocket  │             │
│  │  Manager   │  │    Hub     │             │
│  └─────┬──────┘  └──────┬─────┘             │
└────────┼────────────────┼────────────────────┘
         │                │
    ┌────┴────┐    ┌──────┴──────┐
    │ OpenClaw│    │ NapCat/微信 │
    │ Process │    │ Docker 容器 │
    └─────────┘    └─────────────┘

跟宝塔面板一样，一条命令搞定安装，自动注册系统服务、开机自启动、配置防火墙。

Linux / macOS

curl -sSO https://raw.githubusercontent.com/zhaoxinyi02/ClawPanel/main/scripts/install.sh && sudo bash install.sh

自动完成：下载二进制 → 安装到 /opt/clawpanel → 注册系统服务 → 开机自启动 → 配置防火墙 → 启动。

Windows（PowerShell 管理员）

irm https://raw.githubusercontent.com/zhaoxinyi02/ClawPanel/main/scripts/install.ps1 | iex

或从 Releases 下载 ClawPanel-Setup.exe，右键以管理员身份运行。

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

# Linux
chmod +x clawpanel-linux-amd64 && ./clawpanel-linux-amd64

# macOS
chmod +x clawpanel-darwin-arm64 && ./clawpanel-darwin-arm64

# Windows (双击或命令行)
clawpanel-windows-amd64.exe

启动后访问 http://localhost:19527，默认密码 clawpanel。

git clone https://github.com/zhaoxinyi02/ClawPanel.git
cd ClawPanel
make build        # 构建当前平台
make cross        # 交叉编译所有平台
make installer    # 构建 Windows exe 安装包
./bin/clawpanel

export GOPROXY=https://goproxy.cn,direct
npm config set registry https://registry.npmmirror.com

# systemd (Linux)
systemctl start clawpanel
systemctl stop clawpanel
systemctl restart clawpanel
systemctl status clawpanel
journalctl -u clawpanel -f

# Windows 服务
sc start ClawPanel
sc stop ClawPanel
sc query ClawPanel

⚠️ macOS 支持说明：目前开发者暂无 Mac 设备，近期会购入用于测试。macOS 用户遇到问题请提交 Issue。

完整更新日志请查看 changelogs/ 目录。

• 🧩 插件中心：全新插件市场页面，支持浏览/安装/卸载/配置/更新/启用/禁用插件
• 插件后端：完整的插件生命周期管理 API（/api/plugins/*）
• 插件开发文档：详细的开发规范、JSON Schema、PluginContext API、示例插件
• Windows NapCat 原生安装：Windows 用户安装 NapCat 使用 Shell 版，无需 Docker
• 跨平台安装脚本：所有软件安装脚本支持 macOS (Homebrew) / CentOS (yum) / Ubuntu (apt)
• 反斜杠转义修复：修复 RunScriptWithSudo 中单引号嵌套导致的脚本执行失败（Issue #17）
• macOS 部署优化：修复更新后重启逻辑（launchctl）、PATH 加入 Homebrew 路径（Issue #18）
• NapCat 监控增强：Windows 平台使用 tasklist/taskkill 管理 NapCat 进程

• 配置自动检测 + 一键修复：扫描 OpenClaw/NapCat 配置，检测常见错误并一键修复
• NapCat 掉线自动重连：实时监控连接状态，自动重连，前端状态面板
• 活动日志增强：Bot 回复消息正确显示（支持 message_sent 事件）
• Bug 修复：entrypoint 覆写配置、清除按钮无效、监控误触发重启等

• 全栈重写：后端 Node.js → Go (Gin)，前端 React 18 + TailwindCSS
• 单文件部署：单个静态编译二进制，内嵌前端，无需 Node.js/Docker
• 跨平台：Linux / Windows / macOS (x86_64 / arm64)
• SQLite 持久化：事件日志和配置使用 SQLite 存储
• WebSocket 实时推送：进程日志和消息事件实时推送
• 进程管理器：内置 OpenClaw 进程管理（启动/停止/重启/监控）
• AI 智能助手：内置多模型 AI 对话浮窗
• 软件安装中心：一键安装 Docker、NapCat、微信机器人
• 快捷重启：一键重启 OpenClaw / 网关 / ClawPanel / NapCat
• QR 码修复：智能刷新机制，解决过期二维码问题
• 活动日志增强：显示 Bot 回复消息，持久化存储
• 原生安装脚本：Linux/macOS/Windows 一键安装 + 系统服务注册

• OpenClaw — AI 助手引擎
• Gin — Go Web 框架
• NapCat — QQ 协议框架
• modernc.org/sqlite — 纯 Go SQLite 驱动
• Lucide — 图标库

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

• 严禁商用 — 不得用于任何商业目的
• 封号风险 — 使用第三方客户端登录 QQ/微信可能导致账号被封禁
• 无逆向 — 本项目未进行任何逆向工程
• 自担风险 — 使用者需自行承担一切风险和法律责任

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

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