From 57b8b25946ad0c009a32f59e22124afa5309c5e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=99=B4=E5=A4=A9?= Date: Mon, 30 Mar 2026 23:59:54 +0800 Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E6=96=B0=E5=A2=9E=E5=8D=87?= =?UTF-8?q?=E7=BA=A7/=E5=8D=B8=E8=BD=BD=E6=95=99=E7=A8=8B=20+=20=E6=9B=B4?= =?UTF-8?q?=E6=96=B0=E8=87=B4=E8=B0=A2=E5=88=97=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增「升级面板」章节：macOS/Windows/Linux 桌面版、Linux Web 版、Docker 五种场景 - 新增「卸载面板」章节：五种场景完整卸载步骤，含数据清理警告 - 代码贡献者新增 octo-patch(#163)、SEVENTEEN-TAN(#161)、roc-xie(#162) - 社区反馈者新增 17 位近期 Issue 提交用户 --- README.md | 209 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 209 insertions(+) diff --git a/README.md b/README.md index 500aea0..0501323 100644 --- a/README.md +++ b/README.md @@ -175,6 +175,193 @@ docker run -d --name clawpanel --restart unless-stopped \ 📖 详细教程见 [Docker 部署指南](docs/docker-deploy.md)（含 Compose、自定义镜像、Nginx 反向代理等） +## 升级面板 + +ClawPanel 提供多种升级方式，根据你的安装方式选择对应方案。 + +### macOS / Windows 桌面版升级 + +桌面版内置**自动更新机制**，新版本发布后会自动提示升级： + +1. 打开 ClawPanel，如有新版本会弹出升级提示 +2. 点击「立即升级」，等待下载完成后自动安装重启 +3. 也可前往「关于」页面手动检查更新 + +> **手动升级**：如果自动更新失败，可前往 [Releases](https://github.com/qingchencloud/clawpanel/releases/latest) 下载最新安装包，覆盖安装即可。数据不会丢失。 + +### Linux 桌面版升级 + +| 格式 | 升级命令 | +|------|----------| +| AppImage | 下载最新 `.AppImage` 文件，替换旧文件，`chmod +x` 后运行 | +| DEB | `sudo dpkg -i ClawPanel_最新版本_amd64.deb` | +| RPM | `sudo rpm -U ClawPanel-最新版本-1.x86_64.rpm` | + +### Linux Web 版升级 + +**方式一：一键升级脚本（推荐）** + +```bash +curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash +``` + +脚本会自动检测已有安装，拉取最新代码并重新构建。 + +**方式二：手动升级** + +```bash +cd /opt/clawpanel # 替换为实际安装目录 +git pull origin main +npm install +npm run build +sudo systemctl restart clawpanel +``` + +> **升级 OpenClaw**：面板和 OpenClaw 版本需要匹配。可在「服务管理」页面一键升级，或手动执行： +> ```bash +> sudo npm install -g @qingchencloud/openclaw-zh@latest --registry https://registry.npmmirror.com +> ``` + +### Docker 升级 + +**Docker Compose 方式（推荐）** + +```bash +cd /path/to/clawpanel # 包含 docker-compose.yml 的目录 +docker compose build --no-cache clawpanel +docker compose up -d clawpanel +``` + +**docker run 方式** + +```bash +# 停止并删除旧容器（数据保存在 Volume 中不会丢失） +docker stop clawpanel +docker rm clawpanel + +# 重新启动新容器 +docker run -d --name clawpanel --restart unless-stopped \ + -p 1420:1420 -v clawpanel-data:/root/.openclaw \ + node:22-slim \ + sh -c "apt-get update && apt-get install -y git && \ + npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com && \ + git clone https://github.com/qingchencloud/clawpanel.git /app && \ + cd /app && npm install && npm run build && npm run serve" +``` + +**仅升级容器内的 OpenClaw** + +```bash +docker exec -it clawpanel npm install -g @qingchencloud/openclaw-zh@latest --registry https://registry.npmmirror.com +``` + +### macOS / Windows Web 版升级 + +如果你使用源码部署了 Web 版（非桌面客户端），升级方式与 Linux Web 版一致： + +```bash +cd clawpanel # 替换为实际安装目录 +git pull origin main +npm install +npm run build +npm run serve # 重新启动 +``` + +--- + +## 卸载面板 + +### macOS 桌面版卸载 + +```bash +# 1. 删除应用 +sudo rm -rf /Applications/ClawPanel.app + +# 2. 清理应用数据（可选，删除后配置将丢失） +rm -rf ~/Library/Application\ Support/com.clawpanel.app +rm -rf ~/Library/Caches/com.clawpanel.app +rm -rf ~/Library/Preferences/com.clawpanel.app.plist +``` + +### Windows 桌面版卸载 + +**方式一：通过系统设置** +1. 打开「设置」→「应用」→「已安装的应用」 +2. 搜索 **ClawPanel**，点击「卸载」 + +**方式二：通过控制面板** +1. 打开「控制面板」→「程序」→「卸载程序」 +2. 找到 **ClawPanel**，右键「卸载」 + +**清理残留数据（可选）**： +```powershell +# 删除应用数据 +Remove-Item -Recurse -Force "$env:APPDATA\com.clawpanel.app" +Remove-Item -Recurse -Force "$env:LOCALAPPDATA\com.clawpanel.app" +``` + +### Linux 桌面版卸载 + +| 格式 | 卸载命令 | +|------|----------| +| AppImage | 直接删除 `.AppImage` 文件即可 | +| DEB | `sudo dpkg -r clawpanel` | +| RPM | `sudo rpm -e ClawPanel` | + +清理应用数据（可选）： +```bash +rm -rf ~/.local/share/com.clawpanel.app +rm -rf ~/.config/com.clawpanel.app +``` + +### Linux Web 版卸载 + +```bash +# 1. 停止并禁用服务 +sudo systemctl stop clawpanel +sudo systemctl disable clawpanel + +# 2. 删除 systemd 服务文件 +sudo rm -f /etc/systemd/system/clawpanel.service +sudo systemctl daemon-reload + +# 3. 删除面板代码 +sudo rm -rf /opt/clawpanel + +# 4. 卸载 OpenClaw（可选） +sudo npm uninstall -g @qingchencloud/openclaw-zh + +# 5. 删除 OpenClaw 数据（可选，删除后所有配置和记忆将丢失） +rm -rf ~/.openclaw +``` + +> ⚠️ 第 5 步会删除所有 OpenClaw 配置（API Key、模型设置、Agent 记忆等），请确认不再需要后再执行。 + +### Docker 卸载 + +```bash +# 1. 停止并删除容器 +docker stop clawpanel +docker rm clawpanel + +# 2. 删除镜像（可选） +docker rmi $(docker images --filter "reference=*clawpanel*" -q) 2>/dev/null + +# 3. 删除数据卷（可选，删除后所有配置将丢失） +docker volume rm clawpanel-data +``` + +如果使用 Docker Compose： + +```bash +cd /path/to/clawpanel +docker compose down # 停止并删除容器 +docker compose down -v # 同时删除数据卷（谨慎！） +docker rmi $(docker images --filter "reference=*clawpanel*" -q) 2>/dev/null +``` + +--- + ## 功能特性

@@ -762,6 +949,11 @@ ClawPanel 的成长离不开每一位贡献者的付出。感谢你们让这个
0xsline
#15
jonntd
#18 + +
octo-patch
#163 +
SEVENTEEN-TAN
#161 +
roc-xie
#162 + ### 🐛 社区反馈者 @@ -837,6 +1029,23 @@ ClawPanel 的成长离不开每一位贡献者的付出。感谢你们让这个 + + + + + + + + + + + + + + + + + > 如果遗漏了你的贡献，请 [提交 Issue](https://github.com/qingchencloud/clawpanel/issues/new) 告知我们，我们会第一时间补充！