{"id":45808909,"url":"https://github.com/zhaoxinyi02/clawpanel","last_synced_at":"2026-04-12T18:24:41.701Z","repository":{"id":336846287,"uuid":"1151379841","full_name":"zhaoxinyi02/ClawPanel","owner":"zhaoxinyi02","description":"🐾 ClawPanel — OpenClaw AI 助手可视化管理面板。Go 单二进制部署，支持 20+ 通道统一管理，跨平台，实时日志监控。","archived":false,"fork":false,"pushed_at":"2026-04-06T16:01:32.000Z","size":10715,"stargazers_count":729,"open_issues_count":5,"forks_count":107,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-04-06T17:25:37.474Z","etag":null,"topics":["ai","bot","chatbot","docker","im","napcat","onebot","openclaw","qq","wechat"],"latest_commit_sha":null,"homepage":"https://ClawPanel.cc","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhaoxinyi02.png","metadata":{"files":{"readme":"README.md","changelog":"changelogs/lite-v0.1.0.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-06T11:49:32.000Z","updated_at":"2026-04-06T16:01:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zhaoxinyi02/ClawPanel","commit_stats":null,"previous_names":["zhaoxinyi02/openclaw-qq-plugin","zhaoxinyi02/openclaw-im-manager","zhaoxinyi02/clawpanel"],"tags_count":87,"template":false,"template_full_name":null,"purl":"pkg:github/zhaoxinyi02/ClawPanel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhaoxinyi02%2FClawPanel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhaoxinyi02%2FClawPanel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhaoxinyi02%2FClawPanel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhaoxinyi02%2FClawPanel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhaoxinyi02","download_url":"https://codeload.github.com/zhaoxinyi02/ClawPanel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhaoxinyi02%2FClawPanel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31483380,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T17:22:55.647Z","status":"ssl_error","status_checked_at":"2026-04-06T17:22:54.741Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","bot","chatbot","docker","im","napcat","onebot","openclaw","qq","wechat"],"created_at":"2026-02-26T15:05:22.498Z","updated_at":"2026-04-12T18:24:41.688Z","avatar_url":"https://github.com/zhaoxinyi02.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"img/logo.jpg\" width=\"700\"/\u003e\n\n# ClawPanel\n\n**OpenClaw 智能管理面板 — 现已提供 Pro / Lite 双发行形态，覆盖纯面板接管与开箱即用托管运行时**\n\nGo 单二进制 · React 18 · TailwindCSS · SQLite · WebSocket 实时推送 · 跨平台\n\n[![License](https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-red?style=flat-square)](LICENSE)\n[![Pro](https://img.shields.io/badge/Pro-5.4.4-violet?style=flat-square)](https://github.com/zhaoxinyi02/ClawPanel/releases)\n[![Lite](https://img.shields.io/badge/Lite-0.3.4-2563eb?style=flat-square)](https://github.com/zhaoxinyi02/ClawPanel/releases)\n[![Go](https://img.shields.io/badge/go-1.22+-00ADD8?style=flat-square\u0026logo=go\u0026logoColor=white)](https://go.dev)\n[![React](https://img.shields.io/badge/react-18-61DAFB?style=flat-square\u0026logo=react\u0026logoColor=white)](https://react.dev)\n[![CI](https://github.com/zhaoxinyi02/ClawPanel/actions/workflows/ci.yml/badge.svg)](https://github.com/zhaoxinyi02/ClawPanel/actions/workflows/ci.yml)\n[![Release Build](https://github.com/zhaoxinyi02/ClawPanel/actions/workflows/release.yml/badge.svg)](https://github.com/zhaoxinyi02/ClawPanel/actions/workflows/release.yml)\n[![GitHub Stars](https://img.shields.io/github/stars/zhaoxinyi02/ClawPanel?style=flat-square\u0026logo=github)](https://github.com/zhaoxinyi02/ClawPanel/stargazers)\n\n[快速开始](#-快速开始) · [功能特性](#-主要功能) · [更新日志](changelogs/) · [API 文档](docs/API.md) · [English](README_EN.md)\n\n\u003c/div\u003e\n\n---\n\n\u003e [!CAUTION]\n\u003e **免责声明 | Disclaimer**\n\u003e\n\u003e 本项目仅供**学习研究**使用，**严禁用于任何商业用途**。使用第三方客户端登录 QQ/微信可能违反腾讯服务协议，**存在封号风险**，请使用小号测试。本项目作者**未进行任何逆向工程**，仅做开源项目整合，**不对任何后果承担责任**。下载使用即表示同意 [完整免责声明](DISCLAIMER.md)。\n\u003e\n\u003e This project is for **learning and research purposes only**. **Commercial use is strictly prohibited.** Use at your own risk. See [full disclaimer](DISCLAIMER.md).\n\n\u003e [!NOTE]\n\u003e **最新发布** — `ClawPanel Pro v5.4.4` 与 `ClawPanel Lite v0.3.4` 已发布；本次新增 AI Company 协同编排能力（公司视图、团队与任务流）、增强 Panel Chat 多参与者知识注入与会话一致性，并修复跨分支合并后群聊执行的编译问题。详情见 [changelogs/v5.4.4.md](changelogs/v5.4.4.md) 与 [changelogs/lite-v0.3.4.md](changelogs/lite-v0.3.4.md)。\n\n### 💬 社区交流\n欢迎加入 **ClawPanel 官方交流群**，获取最新更新、反馈问题、参与插件开发。\n\n\u003e 📱 **扫码加入企微群**\n\u003e \n\u003e \u003cimg src=\"img/wecom.jpg\" width=\"300\"/\u003e\n\u003e \n\n\n\n## 主要功能\n\n### Lite / Pro 对比\n\n| 维度 | ClawPanel Lite | ClawPanel Pro |\n|:---|:---|:---|\n| 目标用户 | 新手 / 想开箱即用 | 已有 OpenClaw 环境的进阶用户 |\n| OpenClaw | 内置 `2026.4.8`，安装后直接可用 | 不内置，支持一键安装或外部接管 |\n| 运行时控制 | 面板全托管 | 用户可自行决定 |\n| 通道插件 | 常用插件预置好，默认关闭可直接配置 | 按需安装、按需接管 |\n| 外部 OpenClaw | 不支持 | 支持 |\n| 更新 | 跟随 Lite 独立版本线 | 跟随 Pro 独立版本线 |\n| Linux | 已可用 | 已可用 |\n| macOS | 预览阶段 | 已可用 |\n| Windows | 暂不提供（整包超 2GB 限制，请使用 Pro） | 已可用 |\n\n### Workflow Center 1.0（v5.2.1 重点更新）\n- 工作流设置、模板 CRUD、AI 生成模板、运行列表、步骤详情、事件流与删除实例\n- 支持复杂任务自动接管原会话：即时确认、进度回写、暂停 / 恢复 / 重试 / 审批 / 继续\n- 节点支持 `input / wait_user / approval / ai_plan / ai_task / analyze / summary / publish / end`\n- 模板编辑支持可拖拽可视化画布，节点位置可持久化，并提供一键自动整理\n- 节点支持 `image_generate`，可直接配置提示词来源、模型、产物文件与回传行为\n- 节点支持 `skill` 参数，可自动加载 `SKILL.md` 参与执行\n- 关键步骤结果自动落文件到 OpenClaw 工作区，并在工作流详情页显示产出文件、回传状态、失败原因\n- QQ 私聊 / 群聊与微信（ClawBot）支持工作流图片/文件产物回传，支持预览、下载、单文件重发与批量重发最终文件\n\n### 多智能体控制台（v5.1.x 重点更新）\n- Agent 列表管理：新建 / 编辑 / 删除，支持默认 Agent 设置\n- `Core Files`：可直接查看和保存 Agent 工作区核心文件\n- `Skills · Channels · Cron`：从单 Agent 视角查看技能、通道和定时任务快照\n- `Recent Sessions`：快速巡检当前 Agent 最近活跃会话\n- Bindings 路由规则管理：支持**结构化表单 + JSON 高级模式**，可启停、重排和规则级错误定位\n- 路由预览器：输入 `channel/sender/peer/parentPeer/guildId/teamId/accountId/roles` 快速验证命中 Agent\n\n### 编排监控台（Monitor）\n- **全局拓扑图**：基于 React Flow 的 DAG 可视化，一眼看清所有通道、智能体和路由关系\n- Channel → Agent 绑定路由、Agent → Agent 子代理调用、未绑定通道 → 默认代理回退，三类连线一目了然\n- 点击节点/边查看详细配置：Agent 身份/模型/工具/沙箱，Channel 状态/关联 Agent，Binding 匹配条件/优先级\n- 顶部指标栏：Agent 数、通道数、绑定数、会话总数实时统计\n- 底部状态卡片：每个 Agent 的会话数、最后活跃时间、在线状态\n- dagre 自动分层布局 + 手动拖拽调整，支持缩放/平移/小地图\n- 手动刷新触发渲染，支持暗色模式和中英双语\n\n### 智能仪表盘\n- OpenClaw 进程状态监控（启动/停止/重启）\n- 已启用通道概览、当前模型、运行时间、内存占用\n- 快捷操作：一键重启 OpenClaw / 网关 / ClawPanel / NapCat\n\n### 通道管理（20+ 通道）\n支持 **20+ 种通道**的统一配置和一键启用/禁用：\n- **内置通道**：QQ (NapCat) · 微信 · Telegram · Discord · WhatsApp · Slack · Signal · Google Chat · BlueBubbles · WebChat\n- **插件通道**：飞书 · 钉钉 · 企业微信 · QQ 官方 Bot · IRC · Mattermost · Teams · LINE · Matrix · Twitch\n- **QQ 登录**：扫码 / 快速 / 密码三种方式，支持退出登录和重启 NapCat 容器\n- **QR 码智能刷新**：自动检测过期二维码，重试获取全新二维码\n\n### 配置中心\n- **模型配置**：多提供商管理（OpenAI / Anthropic / Google / DeepSeek / 火山引擎等）\n- **Agent 配置**：系统提示词、温度、最大 Token 数\n- **浏览器控制预设**：可视化切换 `browser.enabled=false` 与 `browser.enabled=true + browser.defaultProfile=\"openclaw\"`，降低误接管系统浏览器的风险\n- **JSON 模式**：直接编辑完整配置 JSON（保存前差异预览）\n- 自动为非 OpenAI 提供商注入 `compat.supportsDeveloperRole=false` 兼容性修复\n- `openclaw.json` 写入前自动快照备份（`backups/pre-edit-*.json`）\n\n### 技能中心 + 插件管理\n- 技能/插件分离展示，搜索筛选\n- 一键启用/禁用，实时扫描已安装技能（内置 + 工作区 + 应用）\n\n### 插件中心\n- **插件市场**：浏览官方/第三方插件列表，按分类筛选（基础、AI 增强、消息处理、娱乐、工具）\n- **一键操作**：安装 / 卸载 / 更新 / 启用 / 禁用插件，无需重启 OpenClaw\n- **可视化配置**：自动读取插件 `plugin.schema.json`，前端动态生成配置表单\n- **插件日志**：实时查看插件运行日志，便于调试\n- **多来源安装**：支持从 GitHub、Gitee 脚本入口、本地目录安装，并根据区域在线选择 GitHub 或香港加速服务器下载构建包\n- **完善的开发文档**：详细的 [插件开发指南](docs/plugin-dev/README.md)、JSON Schema 规范、示例插件\n- **插件冲突检测**：安装前检查 ID、端口、依赖冲突\n\n### 配置自动检测 + 一键修复\n- 自动扫描 OpenClaw/NapCat 核心配置文件，检测常见错误\n- 检测项：`reportSelfMessage`、WS/HTTP 服务状态、端口、Token、模型 API Key 等\n- 前端可视化展示异常项，支持单项修复和「一键修复全部」\n- 修复后自动重启对应进程，配置立即生效\n\n### NapCat 掉线自动重连 + 告警\n- 每 30 秒检测 NapCat 连接状态（容器/WS/HTTP/QQ 登录）\n- 连续离线自动重启（Docker 或 Windows 原生进程），可配置重连次数上限\n- **Windows 原生支持**：Windows 用户安装 NapCat 时自动使用 Shell 版（无需 Docker）\n- 通道管理页面实时状态面板：在线/重连中/登录失效/离线指示灯\n- 手动重连按钮 + 重连日志查看\n- 状态变化通过 WebSocket 实时推送\n\n### 事件日志\n- 实时消息流：QQ 消息、**Bot 回复**、系统事件\n- 按来源/类型筛选、关键词搜索\n- SQLite 持久化存储，重启不丢失\n- 外部服务日志接入（POST /api/events）\n\n### 系统管理\n- 系统环境检测（OS / CPU / Go / OpenClaw 版本）\n- 配置备份与恢复（自动备份当前配置再恢复）\n- 软件安装中心：一键安装 Docker、NapCat、微信机器人等\n- 消息中心：安装任务进度实时追踪\n- 身份文档编辑（IDENTITY.md / USER.md 等）\n- 管理密码修改、版本更新检查\n\n### AI 智能助手\n内置 AI 对话助手浮窗，支持多提供商/多模型切换，自动使用 OpenClaw 配置的 API。\n\n### 面板一键自检更新\n- 基于北京服务器国内加速，解决 GitHub 下载不稳定问题\n- 检查更新 → 下载 → SHA256 校验 → 替换程序 → 自动重启，全自动化\n- **独立更新工具**：更新进程通过 `systemd-run --scope` 隔离运行，主进程停止后更新不中断\n- 更新成功后弹窗展示版本号和更新内容\n- 自动备份旧程序（`.bak`），SHA256 校验防损坏\n- 支持离线更新：上传本地二进制文件直接替换\n\n### OpenClaw 可视化更新\n- 点击「前往更新」跳转独立更新页面，可视化执行 `openclaw update`\n- 实时显示更新步骤、进度条、命令输出日志\n- 自动检测当前版本和 npm 最新版本\n- 更新完成后自动发送网关重启信号\n\n## ❓ 常见问题 \u0026 遇到问题怎么办\n\n\u003e [!TIP]\n\u003e **遇到问题请先在面板中使用 AI 助手（右下角对话图标）提问！** AI 助手已内置完整的 FAQ 知识库，能快速帮你排查和解决问题。\n\n常见问题速查：\n\n| 问题 | 简要解答 |\n|:---|:---|\n| 安装后 `systemctl start` 需要密码 | 需要 sudo 权限，输入 **Linux 系统密码**（不是面板密码） |\n| 面板默认登录密码 | `clawpanel`，首次登录后建议修改 |\n| 访问面板显示空白 / 无法连接 | 检查服务状态、防火墙放行 19527 端口、云安全组 |\n| macOS 安装报错 \"无法验证开发者\" | 运行 `sudo xattr -d com.apple.quarantine /opt/clawpanel/clawpanel` |\n| 检查更新显示\"服务器错误\" | 优先确认服务器能访问 GitHub；国内线路也可改走香港加速服务器，检查出站防火墙 |\n| Browser 在哪里配置 | 面板内进入 `系统配置 → OpenClaw 配置 → 浏览器控制`，可直接管理 `browser.enabled` 与 `browser.defaultProfile` |\n| Windows + WSL 的 OpenClaw 能否给 Pro 用 | 可以，但推荐把 WSL 内的 OpenClaw 当作“外部网关”接入；不要指望 Windows 面板直接双击拉起 WSL 里的 Linux OpenClaw |\n| OpenClaw 版本显示 unknown | 建议通过 npm 安装：`npm i -g openclaw@latest` |\n| 如何卸载 ClawPanel | `sudo systemctl stop clawpanel \u0026\u0026 sudo rm -rf /opt/clawpanel` |\n\n👉 **完整 FAQ 文档**：[docs/FAQ.md](docs/FAQ.md)\n\n## 架构\n\n```\n┌───────────────────────────────────────────────────────────┐\n│                    ClawPanel 统一代码库                    │\n│                                                           │\n│   ┌────────────────────┐        ┌────────────────────┐    │\n│   │   ClawPanel Lite   │        │    ClawPanel Pro   │    │\n│   │  托管运行时发行形态  │        │   纯面板发行形态    │    │\n│   ├────────────────────┤        ├────────────────────┤    │\n│   │ 内置 OpenClaw      │        │ 外部接管 / 一键安装 │    │\n│   │ 预置常用通道插件    │        │ 自定义插件 / 自定义环境 │    │\n│   │ clawlite-openclaw  │        │ 系统 openclaw       │    │\n│   └─────────┬──────────┘        └─────────┬──────────┘    │\n│             │                             │               │\n│      ┌──────┴─────────────────────────────┴──────┐        │\n│      │ Go 后端 + React 前端 + SQLite + Updater    │        │\n│      │ Process Manager / Plugin Manager / WS Hub  │        │\n│      └──────────────────────┬─────────────────────┘        │\n└─────────────────────────────┼───────────────────────────────┘\n                              │\n                   ┌──────────┴──────────┐\n                   │ OpenClaw / NapCat 等 │\n                   │ 运行时与通道资源层    │\n                   └─────────────────────┘\n```\n\n## 技术栈\n\n| 层级 | 技术 |\n|:---|:---|\n| 后端 | Go 1.22+ · Gin · SQLite (modernc.org/sqlite) · gorilla/websocket · golang-jwt |\n| 前端 | React 18 · TypeScript · TailwindCSS · Lucide Icons · Vite |\n| 部署 | 单二进制 · `go:embed` 内嵌前端 · 跨平台静态编译 (`CGO_ENABLED=0`) |\n| AI 引擎 | [OpenClaw](https://openclaw.ai) — 支持 GPT-4o / Claude / Gemini / DeepSeek 等 |\n\n## 快速开始\n\n\u003e 跟宝塔面板一样，一条命令搞定安装，自动注册系统服务、开机自启动、配置防火墙。\n\n### 方式一：一键安装（推荐） \n\n**ClawPanel Lite（Linux，现已可用）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/install-lite.sh\" -o install-lite.sh \u0026\u0026 sudo CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash install-lite.sh\n```\n\n自动完成：下载 Lite Core → 安装到 `/opt/clawpanel-lite` → 注册 `clawpanel-lite` 服务 → 启动内置 OpenClaw。\n\n**ClawPanel Lite（macOS，预览阶段）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/install-lite-macos.sh\" -o install-lite-macos.sh \u0026\u0026 sudo CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash install-lite-macos.sh\n```\n\n说明：当前提供 `darwin-amd64 / darwin-arm64` 预览包，建议先在测试环境验证。安装后如遇“无法验证开发者”提示，可执行 `sudo xattr -d com.apple.quarantine /opt/clawpanel-lite/clawpanel-lite`。\n\n**ClawPanel Pro（Linux / macOS）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/install.sh\" -o install.sh \u0026\u0026 sudo CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash install.sh\n```\n\n自动完成：下载二进制 → 安装到 `/opt/clawpanel` → 注册系统服务 → 开机自启动 → 配置防火墙 → 启动。\n完整安装流程请查看在线文档：[QQ NapCat个人号安装教程](https://doc.weixin.qq.com/doc/w3_AdsADQa9AEcCNNqyBMQ3oQmWG451V?scode=AFoAZAcoAHMV6Hv1R5AdsADQa9AEc)\n\n**Windows（PowerShell 管理员，当前为 Pro 发行形态）**\n\n```powershell\n$env:CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\nirm \"$env:CLAWPANEL_PUBLIC_BASE/scripts/install.ps1\" | iex\n```\n\n\u003e [!NOTE]\n\u003e 安装脚本兼容 **PowerShell 5.1 及以上**版本（Windows 自带版本即可）。脚本会自动从 GitHub 获取最新版本，无需手动指定版本号。\n\n或从 [Releases](https://github.com/zhaoxinyi02/ClawPanel/releases) 手动下载对应版本的 `clawpanel-v\u003cversion\u003e-windows-amd64.exe`，双击或命令行运行。\n\n### 手动更新（面板内更新失败时使用）\n\n\u003e [!IMPORTANT]\n\u003e **Windows + WSL 使用 Pro 的推荐方式**：先在 WSL 内自行启动 `openclaw gateway`，再在 ClawPanel 中把网关模式切到 `remote` 指向 WSL 暴露的网关地址。当前不建议把 Windows 面板进程直接当成 WSL 内 Linux OpenClaw 的拉起器。\n\n\u003e [!TIP]\n\u003e 正常情况下在面板内「系统配置 → 检查更新」即可一键更新。如果你的服务器之前使用旧加速服务器导致更新失败，可运行以下命令手动更新到最新版本，更新后面板内更新功能将恢复正常。\n\n**ClawPanel Pro（Linux / macOS）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/update-pro.sh\" | sudo CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash\n```\n\n**ClawPanel Lite（Linux）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/update-lite.sh\" | sudo CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash\n```\n\n\u003e 脚本会自动：检测当前版本 → 从加速服务器下载最新版（失败自动切 GitHub）→ 停服 → 替换二进制 → 重启服务 → 验证启动。更新失败时自动回滚。\n\n### 一键卸载\n\n**ClawPanel Lite（Linux）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/uninstall-lite.sh\" -o uninstall-lite.sh \u0026\u0026 sudo CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash uninstall-lite.sh\n```\n\n**ClawPanel Lite（macOS）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/uninstall-lite-macos.sh\" -o uninstall-lite-macos.sh \u0026\u0026 sudo CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash uninstall-lite-macos.sh\n```\n\n**ClawPanel Pro（Linux）**\n\n```bash\nsudo systemctl stop clawpanel \u0026\u0026 sudo rm -rf /opt/clawpanel\n```\n\n**ClawPanel Pro（macOS）**\n\n```bash\nsudo launchctl unload /Library/LaunchDaemons/com.clawpanel.service.plist \u0026\u0026 sudo rm -f /Library/LaunchDaemons/com.clawpanel.service.plist \u0026\u0026 sudo rm -rf /opt/clawpanel\n```\n\n**ClawPanel Pro（Windows）**\n\n```powershell\nsc stop ClawPanel; sc delete ClawPanel; Remove-Item -Recurse -Force C:\\ClawPanel\n```\n\n### 卸载本机外部 OpenClaw（不影响 Lite 内嵌运行时）\n\n以下命令用于清理你系统里**单独安装**的 `openclaw`（例如 npm 全局安装、用户目录下的 `~/.openclaw` / `~/openclaw`），**不会删除** Lite 自己安装目录中的内嵌运行时（`/opt/clawpanel-lite/runtime`）。\n\n**Linux / macOS**\n\n```bash\nnpm uninstall -g openclaw || sudo npm uninstall -g openclaw || true\nrm -rf \"$HOME/.openclaw\" \"$HOME/openclaw\"\nsudo rm -f /usr/local/bin/openclaw /usr/local/bin/openclaw-gateway /opt/homebrew/bin/openclaw /opt/homebrew/bin/openclaw-gateway\nsudo rm -rf /usr/local/lib/node_modules/openclaw /opt/homebrew/lib/node_modules/openclaw /usr/lib/node_modules/openclaw\n```\n\n**Windows（PowerShell）**\n\n```powershell\nnpm uninstall -g openclaw\nRemove-Item -Recurse -Force \"$env:USERPROFILE\\.openclaw\",\"$env:USERPROFILE\\openclaw\" -ErrorAction SilentlyContinue\nRemove-Item -Force \"$env:APPDATA\\npm\\openclaw.cmd\",\"$env:APPDATA\\npm\\openclaw\",\"C:\\Program Files\\nodejs\\openclaw.cmd\" -ErrorAction SilentlyContinue\nRemove-Item -Recurse -Force \"$env:APPDATA\\npm\\node_modules\\openclaw\" -ErrorAction SilentlyContinue\n```\n\n### 方式二：手动下载运行\n\n从 [Releases](https://github.com/zhaoxinyi02/ClawPanel/releases) 下载对应平台的二进制文件：\n\n```bash\n# Linux\nchmod +x clawpanel-v\u003cversion\u003e-linux-amd64 \u0026\u0026 ./clawpanel-v\u003cversion\u003e-linux-amd64\n\n# macOS\nchmod +x clawpanel-v\u003cversion\u003e-darwin-arm64 \u0026\u0026 ./clawpanel-v\u003cversion\u003e-darwin-arm64\n\n# Windows (双击或命令行)\nclawpanel-v\u003cversion\u003e-windows-amd64.exe\n```\n\n启动后访问 `http://localhost:19527`，默认密码 `clawpanel`。\n\n\u003e [!WARNING]\n\u003e 手动运行不会注册系统服务，关闭终端后服务会停止。推荐使用一键安装。\n\n### 方式二补充：手动下载构建包后，在当前目录直接安装\n\n如果你已经手动下载好了对应平台的构建包，并且当前终端就在该文件所在目录，可以直接运行下面的“仅安装”脚本；脚本会先在当前目录检测匹配的平台构建包，再执行安装。\n\n**ClawPanel Pro（Linux / macOS）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/install-local-pro.sh\" -o install-local-pro.sh \u0026\u0026 CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash install-local-pro.sh\n```\n\n**ClawPanel Pro（Windows，PowerShell）**\n\n```powershell\n$env:CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\niwr \"$env:CLAWPANEL_PUBLIC_BASE/scripts/install-local-pro.ps1\" -OutFile install-local-pro.ps1; powershell -ExecutionPolicy Bypass -File .\\install-local-pro.ps1\n```\n\n**ClawPanel Lite（Linux / macOS）**\n\n```bash\nexport CLAWPANEL_PUBLIC_BASE=\"http://43.248.142.249:19527\"\ncurl -fsSL \"$CLAWPANEL_PUBLIC_BASE/scripts/install-local-lite.sh\" -o install-local-lite.sh \u0026\u0026 CLAWPANEL_PUBLIC_BASE=\"$CLAWPANEL_PUBLIC_BASE\" bash install-local-lite.sh\n```\n\n### 方式三：从源码构建\n\n```bash\ngit clone https://github.com/zhaoxinyi02/ClawPanel.git\ncd ClawPanel\nmake build        # 构建当前平台\nmake cross        # 交叉编译所有平台\nmake installer    # 构建 Windows exe 安装包\n./bin/clawpanel\n```\n\n\u003e [!TIP]\n\u003e 构建需要 Go 1.22+ 和 Node.js 18+。中国大陆用户请设置：\n\u003e ```bash\n\u003e export GOPROXY=https://goproxy.cn,direct\n\u003e npm config set registry https://registry.npmmirror.com\n\u003e ```\n\n### 本地测试与覆盖率\n\n开发或提交前，建议至少运行一次以下命令：\n\n```bash\ngo test ./...\ngo test ./... -coverprofile=local/coverage.out\ngo tool cover -func=local/coverage.out\n```\n\n如果只想快速验证近期改动，可先跑相关包：\n\n```bash\ngo test ./internal/eventlog ./internal/updater\n```\n\n## GitHub Actions 自动化\n\n已内置两条工作流，覆盖自动测试与自动打包发布：\n\n- `release.yml` 现支持双发行形态：\n  - `pro-vX.Y.Z`\n  - `lite-vX.Y.Z`\n- `Lite / Pro` 使用独立更新元数据：\n  - `release/update-pro.json`\n  - `release/update-lite.json`\n- 安装脚本从 Gitee 获取，构建包下载与更新默认走“GitHub / 香港加速服务器”双线路\n\n- `CI`（`.github/workflows/ci.yml`）\n  - 触发：`push` / `pull_request` / 手动触发\n  - 执行：\n    - `go vet ./...`\n    - `go test -count=1 -shuffle=on ./...`（`ubuntu/windows` 矩阵）\n    - `go test -race -covermode=atomic -coverprofile=coverage.out ./...`\n    - `web npm ci + npm run build`\n    - 后端嵌入前端产物构建（`make backend-only`）\n  - 产物：\n    - `go-coverage`（`coverage.out` + `coverage.txt`）\n    - `frontend-dist`\n    - `clawpanel-linux-amd64-ci`（用于快速验收）\n- `Release Build`（`.github/workflows/release.yml`）\n  - 触发：`push tag lite-v* / pro-v*`（如 `lite-v0.1.3`、`pro-v5.2.7`）/ 手动触发\n  - 执行：自动构建 `linux/darwin/windows` 多平台二进制 + `ClawPanel-Setup-v{version}.exe`\n  - 发布：tag 触发时自动上传到 GitHub Release，并生成 `checksums.txt`\n\n另外，已启用 `Dependabot`（`.github/dependabot.yml`）每周自动检查 GitHub Actions 依赖更新。\n\n示例：\n\n```bash\ngit tag lite-v0.1.3\ngit push origin lite-v0.1.3\n\ngit tag pro-v5.2.7\ngit push origin pro-v5.2.7\n```\n\n## 环境变量\n\n| 变量 | 默认值 | 说明 |\n|:---|:---|:---|\n| `CLAWPANEL_PORT` | `19527` | Web 服务端口 |\n| `CLAWPANEL_DATA` | `./data` | 数据目录（配置 + 数据库） |\n| `OPENCLAW_DIR` | `~/.openclaw` | OpenClaw 配置目录 |\n| `OPENCLAW_CONFIG` | - | OpenClaw 配置文件路径（自动推导目录） |\n| `OPENCLAW_APP` | - | OpenClaw 应用目录（用于技能扫描） |\n| `OPENCLAW_WORK` | - | OpenClaw 工作目录 |\n| `CLAWPANEL_SECRET` | 随机 | JWT 签名密钥 |\n| `ADMIN_TOKEN` | `clawpanel` | 管理密码 |\n| `CLAWPANEL_DEBUG` | `false` | 调试模式 |\n| `LEGACY_SINGLE_AGENT` | `false` | 启用后退回单 Agent 兼容模式（隐藏多智能体写操作） |\n\n## 服务管理\n\n```bash\n# systemd (Linux)\nsystemctl start clawpanel\nsystemctl stop clawpanel\nsystemctl restart clawpanel\nsystemctl status clawpanel\njournalctl -u clawpanel -f\n\n# Windows 服务\nsc start ClawPanel\nsc stop ClawPanel\nsc query ClawPanel\n```\n\n## 跨平台支持\n\n| 平台 | 架构 | 二进制文件 |\n|:---:|:---:|:---|\n| Linux | x86_64 | `clawpanel-v\u003cversion\u003e-linux-amd64` |\n| Linux | ARM64 | `clawpanel-v\u003cversion\u003e-linux-arm64` |\n| macOS | x86_64 | `clawpanel-v\u003cversion\u003e-darwin-amd64` |\n| macOS | ARM64 (M1/M2/M3) | `clawpanel-v\u003cversion\u003e-darwin-arm64` |\n| Windows | x86_64 | `clawpanel-v\u003cversion\u003e-windows-amd64.exe` |\n\n## 更新日志\n\n完整更新日志请查看 [changelogs/](changelogs/) 目录。\n\n### Lite 最近 3 次\n\n#### v0.1.13 — 自定义技能配置表单与复制能力补齐\n- **🧩 skill.json 配置直连面板 UI**：自定义技能的 `configSchema` 现在会渲染成结构化表单，可直接保存配置\n- **📋 技能复制到其他智能体 / 全局**：已安装技能支持直接复制，便于多智能体复用\n- **⚡ 前端与通道体验同步增强**：合入隐藏标签页暂停轮询、Channels 并行加载与飞书多 ID 兼容\n\n#### v0.1.11 — 通道消息回复修复\n- **🩹 修复通道无法回复消息**：`SaveChannel` 保存凭证时会覆盖 `channels[id]` 整个对象，导致 `enabled` 字段丢失，通道变为未启用状态\n- **📁 修复 AGENTS.md 模板缺失**：打包脚本 `prune_openclaw_runtime` 直接删除整个 `docs/` 目录，导致 agent 启动时找不到工作区模板而报错退出\n- **🔌 修复飞书 plugin entry key 错误**：`SwitchFeishuVariant` 在 Lite 版写入 `feishu-openclaw-plugin` entry 导致 OpenClaw plugin id mismatch\n- **🔄 安装脚本自动获取最新版**：去除硬编码兜底版本号，网络无法获取时明确报错并提示手动指定 `VERSION=x.y.z`\n\n#### v0.1.10 — Linux Fresh Install 稳定性修复 + Windows Lite 暂停提供\n- **🩹 Linux Lite 新装修复**：修复 fresh Linux Lite 安装后 OpenClaw / gateway 离线的问题\n- **🧠 memory slot 默认保护**：默认写入 `plugins.slots.memory = \"none\"`，避免内置 `memory-core` 缺失时直接导致配置无效\n- **📈 服务内存参数补强**：Lite 服务默认增加 `NODE_OPTIONS=--max-old-space-size=2048`，降低 gateway OOM 风险\n- **🪟 暂停提供 Windows Lite**：Windows 整包超过 GitHub Release 2GB 上传限制，Windows 用户请使用 Pro 版\n\n#### v0.1.9 — Gitee 同步与预览发布链继续收口\n- **🔁 Gitee Release 自动同步**：GitHub 发布后自动同步生成同名 Gitee Release，为国内线路切换做准备\n- **🪟🍎 Lite 预览构建继续推进**：Windows / macOS Lite 继续通过 GitHub Actions 原生 runner 构建预览整包\n- **📦 Linux Lite 仍为正式可用版**：当前仍建议正式使用 Linux Lite，Windows / macOS Lite 保持预览验证节奏\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e更早 Lite 版本\u003c/b\u003e\u003c/summary\u003e\n\n#### v0.1.8 — Lite runtime 依赖 hotfix\n- **📦 修复 Lite 包漏打 OpenClaw 运行时依赖**：补齐 `tslog` 等 production 依赖，解决 `dist/entry.js` 可见但无法导入的问题\n- **🧪 打包阶段新增 runtime smoke test**：构建时直接校验 `import(\"./dist/entry.js\")`，防止缺依赖包再次发布\n- **🧭 启动路径与工作目录继续收口**：Lite 的 launcher、CLI 与网关命令统一对齐内嵌 OpenClaw app 目录\n\n#### v0.1.7 — Lite 运行时隔离正式收口\n- **🔒 Lite 与本机外部 OpenClaw 进一步隔离**：`OpenClawInstalled`、网关重启候选、进程管理器查找与插件 CLI 执行统一收口到内嵌运行时\n- **📦 Lite 更新语义更明确**：Lite 不再走单独 OpenClaw 更新，统一按整包更新处理，避免误碰系统全局 `openclaw`\n- **🧪 三端安装/卸载入口已校验**：Linux / macOS / Windows 的公开安装与卸载脚本从 Gitee 获取，构建包与更新元数据同步到香港加速服务器\n\n#### v0.1.6 — Lite 运行时探测收口\n- **🧭 Windows / macOS Lite 优先绑定内置运行时**：版本检测、重启命令与运行路径优先走 `clawlite-openclaw`，避免误探测到本机外部 `openclaw`\n- **🧹 新增外部 OpenClaw 卸载说明**：README 中补充 Linux / macOS / Windows 清理本机外部 `openclaw` 的命令，并明确不会影响 Lite 内嵌 runtime\n- **📌 内置 OpenClaw 版本保持不变**：Lite 继续固定内嵌 `2026.4.5`\n\n#### v0.1.5 — Windows / macOS Lite 打包脚手架推进\n- **🧱 多平台 Lite 打包骨架**：补齐 `macOS / Windows Lite` 的安装脚本、launcher 和整包命名规范，为后续原生构建做准备\n- **⚙️ GitHub Actions 原生构建方向**：Lite 打包链开始区分 `ubuntu / macOS / Windows` runner，不再把跨平台整包强行全放在 Linux 上拼装\n- **📚 文档同步更新**：README 中明确 Windows / macOS Lite 仍处于预览推进阶段，建议当前优先使用 Linux Lite\n\n#### v0.1.4 — 整包更新与线路选择\n- **📦 Lite 改为整包更新**：面板内更新会同步面板、内置 OpenClaw 与预置插件，只替换程序和 runtime，保留现有 data 目录\n- **🌐 安装/更新可选下载线路**：新增 GitHub / 香港加速服务器线路选择，并给出\"中国香港及境外 / 中国大陆\"推荐提示\n- **🏷️ 版本管理更明确**：系统配置 → 版本管理会明确标出当前是 `Lite` 还是 `Pro`\n\n#### v0.1.3 — 更新页代理修复与版本体验补强\n- **🔄 更新页可直接打开**：修复\"前往更新\"跳转后显示\"当前无法使用此页面\"的问题，改为通过面板自身代理访问独立更新器\n- **🏷️ 当前版本显示更准**：回到版本页或重新检测更新时会刷新当前版本，避免升级后仍显示旧版本\n- **📦 Lite 发布链继续收口**：同步文档、更新元数据、安装脚本与 `0.1.3` 版本号\n\n#### v0.1.1 — 模型配置和开箱即用体验继续收口\n- **🧠 模型服务商更干净**：快速添加模型服务商时不再自动塞入过时模型 ID，而是默认创建一个空模型项，用户可直接填写自己想用的模型\n- **🛠️ 故障提示更直接**：当 OpenClaw 与网关均离线时，面板会明确提示尝试点击左下角手动重启 OpenClaw\n- **📦 发布体验补强**：Lite 版本提升到 `0.1.1`，安装脚本、文档、更新元数据与自动发布链同步对齐\n\n#### v0.1.0 — 首个 Linux 可用版\n- **🚀 Linux 首发可用**：安装后直接内置 OpenClaw `2026.4.5`，用户只需配置 API Key 与常用通道凭据即可开始使用\n- **🔌 常用通道开箱可配**：预置 `telegram`、`qq`、`qqbot`、`feishu`、`dingtalk`、`wecom`，默认关闭但可直接配置启用\n- **🧩 Lite 独立版本线**：新增 Lite 专用安装 / 卸载 / 更新能力，并与 Pro 彻底分成两条发行线\n\n\u003c/details\u003e\n\n### Pro 最近 3 次\n\n#### v5.2.13 — 自定义技能市场与模型配置体验升级\n- **🧩 自定义技能配置表单上线**：`skill.json` 的结构化配置正式接入 Skills 页面，可直接编辑与保存\n- **📋 技能复制能力补齐**：已安装技能支持复制到其他智能体或全局目录，不再误走商店安装链路\n- **⚡ PR #75 合并落地**：飞书多 ID、前端性能优化、模型高级配置 UI 与技能页增强同步合入主线\n\n#### v5.2.11 — 前端性能优化与 Agent/Channel 稳定性修复\n- **⚡ 前端页面懒加载**：路由页面 Suspense 懒加载，显著提升首屏加载速度\n- **🧠 Agent/Channel 稳定性修复**：修复合并后的多项 agent/channel 流程问题，支持外部 agentDir 与飞书配置校验修正\n- **🧪 CI 跨平台测试修复**：修复 macOS/Windows symlink 导致的 agent workspace 测试失败\n- **📦 安装入口切换 Gitee**：安装脚本与文档统一切换到 Gitee 入口，减少国内用户访问不稳定\n\n#### v5.2.10 — 发布链路与国内镜像同步补强\n- **🔁 Gitee Release 自动同步**：GitHub Release 完成后自动在 Gitee 创建同名 Release 并同步资产，减轻国内访问压力\n- **📦 Lite / Pro 发布链继续收口**：为后续国内用户 `GitHub / Gitee` 线路选择做好准备\n- **🧰 安装文档补全**：README 中继续补齐 Lite / Pro 多平台安装与卸载说明\n\n#### v5.2.8 — 探测与配置体验补强\n- **🍎 macOS OpenClaw 探测增强**：补强 `/Users/*/.openclaw` 与真实用户 home 识别，减少先装 OpenClaw 后装面板时的识别失败\n- **🗂️ 受管工作区兼容增强**：兼容 `workspace` / `workspaces` 等目录结构，减少 Agent 文件编辑异常\n- **🧠 MiniMax 默认配置修正**：默认 provider 配置更新为 `https://api.minimaxi.com/anthropic/v1` + `MiniMax-M2.5`\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e更早 Pro 版本\u003c/b\u003e\u003c/summary\u003e\n\n#### v5.2.7 — QQ / 插件镜像 / 通道安装体验收口\n- **🧹 QQ (NapCat) 通道补强**：新增一键删除、更稳的账号级 OneBot 配置修复与状态识别\n- **🛒 插件通道体验提升**：插件型通道可直接在通道页安装，不再强制跳转插件中心\n- **🌐 插件仓库镜像兜底**：补齐镜像并新增 Gitee 回退，减少用户只看到部分插件的问题\n\n#### v5.2.6 — OpenClaw 运行状态与 Telegram 体验修复\n- **📊 运行时状态更真实**：新增 OpenClaw / 网关健康判断，避免\"系统运行正常\"误导\n- **✈️ Telegram 可用性修复**：修复保存 schema、自动 reload 与前端状态刷新问题\n- **🛠️ 安装链路补强**：继续收口 OpenClaw 安装与运行环境探测逻辑\n\n#### v5.2.5 — 多智能体与插件体系继续稳定\n- **🧠 多智能体管理增强**：补强工作区、上下文与路由相关行为\n- **🧩 插件体系稳定性提升**：继续修复安装、配置同步与状态管理问题\n- **🐛 通道配置链路修复**：减少保存后配置丢失和状态不同步问题\n\n#### v5.2.4 — 工作流与系统配置持续打磨\n- **🔁 工作流体验补强**：继续完善多步任务、事件流与详情页展示\n- **⚙️ 系统配置收口**：补强模型、浏览器和 JSON 模式配置写入行为\n- **📡 运行时探测增强**：提升 OpenClaw / 网关状态判断稳定性\n\n#### v5.2.3 — 前端结构与通道管理优化\n- **🎨 页面结构调整**：继续整理现代化界面与仪表盘布局\n- **📻 通道管理优化**：统一更多通道卡片与启停/保存行为\n- **🧪 稳定性修复**：修复若干配置页和运行状态相关问题\n\n### v5.2.1 — Workflow Center 1.0 正式完成\n- **🧠 工作流中心上线**：新增工作流设置、模板管理、AI 生成模板、运行列表、步骤详情、事件流与中文化控制界面，工作流 1.0 正式可用\n- **🔁 原会话自动接管**：复杂任务可在 QQ / 飞书 / 企业微信链路中自动接管，支持即时确认、审批、暂停、恢复、重试、继续与多实例并发\n- **📁 文件产出与回传**：关键步骤结果自动写入 OpenClaw 工作区，QQ 私聊 / 群聊支持完成后自动回传最终文件，详情页支持预览、下载、重发与批量重发\n- **🛠️ 运行时补强**：工作流节点支持 `skill`，活动日志接入多来源消息流，消息中心同步工作流状态并过滤已取消实例\n- **🐛 稳定性修复**：修复重复建单、等待输入无法继续、审批恢复异常、模型协议兼容、异常文件名与中后段步骤超时等问题\n\n### v5.1.8 — 移动端优化、插件中心修正与通道配置收口\n- **📱 移动端体验重做**：新增移动端玻璃顶栏、底部导航、操作托盘与 AI 助手全屏模式，页面不再只是桌面布局压缩\n- **🧊 玻璃风继续统一**：AI 助手入口与悬浮窗、智能体详情标签、多个页面工具栏与操作按钮继续收口到统一蓝色玻璃风\n- **🧩 插件与通道修复**：插件中心作者来源显示规则统一，通道页已安装状态改为和插件中心同源；企业微信拆分为 `智能机器人 / 自建应用`，钉钉切到新版 `Client ID / Client Secret` 配置\n- **🛡️ 配置安全性增强**：为多个通道加入“未完成关键配置不能启用”校验，避免空配置直接打开导致运行异常\n- **🐛 稳定性修复**：修复定时任务页白屏、AI 助手切换模型白屏、插件中心通知被顶栏遮挡等问题\n\n### v5.1.7 — 现代蓝色玻璃 UI 收口与智能体工作台增强\n- **🎨 现代化界面统一**：面板前端正式收口到 modern-only 方向，整体切到蓝色玻璃风，顶部搜索、头像菜单、右上角消息中心与深色模式质感同步升级\n- **🧠 智能体工作台补强**：`概览 / 模型与身份 / 工具与权限 / 核心文件 / 技能与上下文 / 路由上下文 / 高级 JSON` 全部切到统一玻璃标签与操作样式，并继续清理中文模式下的中英混写\n- **📊 仪表盘状态更直观**：首页新增 `OpenClaw` 与 `网关` 状态卡，`今日消息` 统计改为排除 `system` 日志，更接近真实消息流\n- **⚙️ 模型配置更干净**：`系统配置 -\u003e 模型配置` 中每个提供商卡片不再重复显示 `国内 / 国际 / 聚合` 快捷行，统一只在顶部 `快速添加模型服务商` 区域操作\n\n### v5.1.6 — 修复 QQ 插件安装链路与 NapCat 状态误判\n- **🐛 QQ 插件安装前置**：安装 `QQ (NapCat)` 时会先确保 `qq` 插件安装成功，失败则直接报错终止，不再继续写坏 `openclaw.json`\n- **🧩 插件缺失提示更明确**：QQ 通道页和系统环境页会明确显示 `QQ 个人号插件未安装 / 缺少插件`，不再把 NapCat 误判成正常已安装\n- **🔄 QQ 开关即时生效**：保存 QQ 配置后自动重启 OpenClaw 网关，撤回通知、成员变动、欢迎语、戳一戳等开关立即生效\n- **🛒 插件中心兜底拉取仓库**：插件列表为空时会主动刷新 registry，降低“插件商店打不开”的概率\n\n### v5.1.5 — Agent 核心文件、网关探测增强与飞书切换修复\n- **🧠 Agent 工作区增强**：新增 `Core Files`、`Skills · Channels · Cron`、`Recent Sessions` 等工作台能力，更接近官方单 Agent 管理体验\n- **🛡️ 网关与启动稳定性提升**：启动时可识别外部管理中的 OpenClaw，按 `gateway.bind` 精确探测端口，减少误判和重复拉起\n- **🪟 Windows CI 修复**：修正 `launch_windows.go` 中的 Windows `unsafe.Pointer` / 环境块处理问题，恢复 `windows-2025` CI 绿灯\n- **🔀 飞书双版本切换收口**：切换前校验目标插件是否已安装，前端未安装版本禁用切换，避免切到不可用实现\n\n### v5.0.24 — 修复 QQ 唤醒配置不生效（Issue #21）\n- **🐛 修复 QQ 唤醒配置不生效**：修复 `wakeProbability`、`wakeTrigger` 等配置仅在面板展示但未落到插件实际生效路径的问题\n- **✨ 兼容旧配置字段**：后端保存 QQ 通道配置时自动迁移旧字段（`wakeProbability`/`wakeTrigger`/`minSendIntervalMs`/`autoApprove*`）到新版结构，避免升级后失效\n\n### v5.0.14 — 脚本修复 · Windows 兼容性\n- **🐛 install.ps1 兼容 PowerShell 5.1**：移除三元运算符，Windows 自带 PS 5.1 可直接运行\n- **✨ 安装脚本自动获取最新版本**：`install.sh` / `install.ps1` 启动时自动从 GitHub API 拉取最新版本号，无需随每次发版更新脚本\n- **🐛 Windows 安装 OpenClaw 不再因缺少 Node.js 退出**：自动通过 winget 安装 Node.js LTS 后继续\n\n### v5.0.13 — 修复 QQ 插件强制注入\n- **🐛 修复 QQ 插件配置强制写入**：仅在 QQ 插件已安装且 NapCat 运行时才注入 `channels.qq`，避免未使用 QQ 的用户 OpenClaw 网关启动失败\n\n### v5.0.12 — OpenClaw 可视化更新 · 版本显示修复\n- **✨ OpenClaw 可视化更新界面**：实时显示更新步骤、进度条、命令输出日志\n- **🐛 版本更新页显示旧版本**：`GetVersion` API 改用 `openclaw --version` 获取真实版本，不再读取 `lastTouchedVersion`\n- **🐛 ClawPanel 版本号显示错误**：版本号改为 ldflags 动态注入，修复硬编码导致显示错误\n- **✨ OpenClaw 网关 daemon fork 模式检测**：正确识别 daemon fork 启动，防止误判崩溃\n\n### v5.0.3 — 插件中心 · Windows NapCat · 跨平台修复\n- **🧩 插件中心**：全新插件市场页面，支持浏览/安装/卸载/配置/更新/启用/禁用插件\n- **插件后端**：完整的插件生命周期管理 API（`/api/plugins/*`）\n- **插件开发文档**：详细的开发规范、JSON Schema、PluginContext API、示例插件\n- **Windows NapCat 原生安装**：Windows 用户安装 NapCat 使用 Shell 版，无需 Docker\n- **跨平台安装脚本**：所有软件安装脚本支持 macOS (Homebrew) / CentOS (yum) / Ubuntu (apt)\n- **反斜杠转义修复**：修复 `RunScriptWithSudo` 中单引号嵌套导致的脚本执行失败（Issue #17）\n- **macOS 部署优化**：修复更新后重启逻辑（launchctl）、PATH 加入 Homebrew 路径（Issue #18）\n- **NapCat 监控增强**：Windows 平台使用 tasklist/taskkill 管理 NapCat 进程\n\n### v5.0.1 — 配置检测 · 连接监控 · 活动日志增强 (2026-02-24)\n- **配置自动检测 + 一键修复**：扫描 OpenClaw/NapCat 配置，检测常见错误并一键修复\n- **NapCat 掉线自动重连**：实时监控连接状态，自动重连，前端状态面板\n- **活动日志增强**：Bot 回复消息正确显示（支持 `message_sent` 事件）\n- **Bug 修复**：entrypoint 覆写配置、清除按钮无效、监控误触发重启等\n\n### v5.0.0 — 全栈重写 (2026-02-22)\n- **全栈重写**：后端 Node.js → Go (Gin)，前端 React 18 + TailwindCSS\n- **单文件部署**：单个静态编译二进制，内嵌前端，无需 Node.js/Docker\n- **跨平台**：Linux / Windows / macOS (x86_64 / arm64)\n- **SQLite 持久化**：事件日志和配置使用 SQLite 存储\n- **WebSocket 实时推送**：进程日志和消息事件实时推送\n- **进程管理器**：内置 OpenClaw 进程管理（启动/停止/重启/监控）\n- **AI 智能助手**：内置多模型 AI 对话浮窗\n- **软件安装中心**：一键安装 Docker、NapCat、微信机器人\n- **快捷重启**：一键重启 OpenClaw / 网关 / ClawPanel / NapCat\n- **QR 码修复**：智能刷新机制，解决过期二维码问题\n- **活动日志增强**：显示 Bot 回复消息，持久化存储\n- **原生安装脚本**：Linux/macOS/Windows 一键安装 + 系统服务注册\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003ev4.x 及更早版本\u003c/b\u003e\u003c/summary\u003e\n\n- **v4.4.0** (2026-02-21) — AI 助手、模型兼容性修复\n- **v4.3.0** (2026-02-19) — 技能插件分离、修改密码、多语言、原生安装脚本\n- **v4.2.x** (2026-02-16~17) — 紫罗兰主题、通道显示修复、QQ 登录修复\n- **v4.1.0** (2026-02-14) — 20+ 通道、技能中心、6 标签页系统配置\n- **v4.0.0** (2026-02-13) — ClawPanel 品牌升级\n- **v3.0.0** (2026-02-10) — QQ + 微信双通道\n- **v2.0.0** (2026-02-09) — React + TailwindCSS 管理后台\n- **v1.0.0** — 基础管理后台 + NapCat Docker 集成\n\u003c/details\u003e\n\u003c/details\u003e\n\n## 致谢\n\n### 开发者与贡献者\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/zhaoxinyi02\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/98445030?v=4\" width=\"64\" height=\"64\" alt=\"zhaoxinyi02\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/BlueSkyXN\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/63384277?v=4\" width=\"64\" height=\"64\" alt=\"BlueSkyXN\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Hns16\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/192765150?v=4\" width=\"64\" height=\"64\" alt=\"Hns16\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/codeKing6412\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/185812512?v=4\" width=\"64\" height=\"64\" alt=\"codeKing6412\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Karovia\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/7569287?v=4\" width=\"64\" height=\"64\" alt=\"Karovia\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/zhaoxinyi02\"\u003ezhaoxinyi02\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/BlueSkyXN\"\u003eBlueSkyXN\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/Hns16\"\u003eHns16\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/codeKing6412\"\u003ecodeKing6412\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/Karovia\"\u003eKarovia\u003c/a\u003e\n\u003c/p\u003e\n\n- 感谢所有为 `ClawPanel` 提交代码、反馈问题和参与设计讨论的开发者与贡献者\n\n- [OpenClaw](https://openclaw.ai) — AI 助手引擎\n- [Gin](https://github.com/gin-gonic/gin) — Go Web 框架\n- [NapCat](https://github.com/NapNeko/NapCatQQ) — QQ 协议框架\n- [modernc.org/sqlite](https://pkg.go.dev/modernc.org/sqlite) — 纯 Go SQLite 驱动\n- [Lucide](https://lucide.dev) — 图标库\n\n## 免责声明\n\n\u003e **本项目仅供学习研究使用，严禁商用。**\n\n- **严禁商用** — 不得用于任何商业目的\n- **封号风险** — 使用第三方客户端登录 QQ/微信可能导致账号被封禁\n- **无逆向** — 本项目未进行任何逆向工程\n- **自担风险** — 使用者需自行承担一切风险和法律责任\n\n**详细免责声明请阅读 [DISCLAIMER.md](DISCLAIMER.md)**\n\n## License\n\n[CC BY-NC-SA 4.0](LICENSE) © 2026 — **禁止商用**\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=zhaoxinyi02/ClawPanel\u0026type=date\u0026legend=top-left)](https://www.star-history.com/#zhaoxinyi02/ClawPanel\u0026type=date\u0026legend=top-left)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhaoxinyi02%2Fclawpanel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhaoxinyi02%2Fclawpanel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhaoxinyi02%2Fclawpanel/lists"}