ClawPanel 升级与卸载全指南：桌面版、Web版与Docker版本管理完整清单
【免费下载链接】clawpanel🦞 OpenClaw & Hermes Agent 多引擎 AI 管理面板 — 内置 AI 助手（工具调用 + 图片识别 + 多模态），一键安装 | Tauri v2 跨平台桌面应用 | 11 种语言项目地址: https://gitcode.com/qingchencloud/clawpanel
ClawPanel 是 OpenClaw & Hermes Agent 多引擎 AI 管理面板，内置 AI 助手、一键安装与多模态能力，支持 Tauri v2 桌面应用、Web 版与 Docker 部署，并提供 11 种语言界面。本文面向新手，完整梳理 ClawPanel 的升级步骤与卸载方法，覆盖桌面版、Web 版与 Docker 三种安装方式，帮助你在版本管理与卸载清理时不丢数据、少踩坑。
为什么升级和卸载方式取决于你的安装方式
ClawPanel 有三种典型安装形态，升级/卸载命令完全不同，先对照确认你属于哪一类：
| 安装方式 | 典型场景 | 升级入口 | 卸载方式 |
|---|---|---|---|
| 桌面版（Win/macOS/Linux） | 个人电脑日常使用 | 应用内提示 + 「关于」页 | 系统卸载器 |
| Web 版（Linux/服务器） | 云服务器、NAS、家庭实验室 | 一键脚本 /git pull | 停止服务 + 删目录 |
| Docker 版 | 容器化部署 | 重建镜像 /git pull | 删容器 + 删数据卷 |
💡 关键原则：升级换的是面板代码，数据在
~/.openclaw/；只要数据目录没动，覆盖安装不会丢配置、API Key 和 Agent 记忆。
桌面版升级：一键检查更新与覆盖安装
如何快速升级 Windows / macOS 桌面版
桌面版通过官网版本接口检查新版本，发现新版后会推荐适合当前系统的完整安装包：
- 打开 ClawPanel，如有新版本会弹出升级提示
- 点击「下载推荐安装包」，浏览器从官网镜像下载
- 退出 ClawPanel，按系统安装器提示覆盖安装即可
- 也可前往「关于」页面手动检查更新
如果官网下载失败，可下载最新安装包直接覆盖安装，数据不会丢失。「关于」页面还会展示 ClawPanel 与 OpenClaw 各自绑定的版本状态，方便你核对是否都已更新。版本管理逻辑参考 src/pages/about.js，更新检查实现见 src-tauri/src/commands/update.rs。
Linux 桌面版升级命令速查
| 格式 | 升级命令 |
|---|---|
| AppImage | 下载最新.AppImage替换旧文件，chmod +x后运行 |
| DEB | sudo dpkg -i ClawPanel_最新版本_amd64.deb |
| RPM | sudo rpm -U ClawPanel-最新版本-1.x86_64.rpm |
Web 版升级：一键脚本与手动 git pull
Web 版部署在 Linux 服务器上，默认访问地址为http://服务器IP:1420。
最快升级方法：一键升级脚本
系统级安装（/opt/clawpanel）：
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | sudo bash普通用户安装（~/.local/share/clawpanel）：
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash脚本会自动读取 systemd 服务的实际工作目录，执行git pull --ff-only拉取代码、重新构建并重启服务。拉取失败、存在未提交修改或权限模式不匹配时，脚本会明确报错并停止，不会用旧源码继续构建。脚本逻辑见 scripts/linux-deploy.sh。
手动升级 Web 版的完整步骤
cd /opt/clawpanel # 替换为实际安装目录 git status --short # 有输出时先处理本地修改 git pull --ff-only origin main npm install npm run build sudo systemctl restart clawpanel普通用户服务将最后一行替换为systemctl --user restart clawpanel。
⚠️两条注意事项：
- Web 版不能只覆盖
dist/：页面前端、Node API 与 WebSocket 代理必须同版本，/__api/health会自动核对前后端版本，不一致会停止加载- 升级后浏览器仍显示旧页面时，按
Ctrl+F5强制刷新
国内网络拉取失败时，可把 Git 远程切换到镜像源后再git pull --ff-only。详细教程见 docs/linux-deploy.md。
Docker 版升级：重建镜像与容器替换
Docker Compose 方式（推荐）
cd /path/to/clawpanel docker compose build --no-cache clawpanel docker compose up -d clawpaneldocker run 方式
# 停止并删除旧容器（数据在 Volume 中，不会丢失） docker stop clawpanel && docker rm clawpanel # 按原启动命令重新启动新容器 docker run -d --name clawpanel --restart unless-stopped \ -p 1420:1420 -v clawpanel-data:/root/.openclaw \ clawpanel仅升级容器内的 OpenClaw
如果只需升级 OpenClaw 引擎而不动面板：
docker exec -it clawpanel npm install -g @qingchencloud/openclaw-zh@latest --registry https://registry.npmmirror.com完整的 Compose 配置、自定义 Dockerfile 与 Nginx 反向代理方案见 docs/docker-deploy.md，Compose 示例参考 docker-compose.yml。
卸载 ClawPanel：按系统逐一清理
macOS 桌面版卸载
# 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.plistWindows 桌面版卸载
- 「设置」→「应用」→「已安装的应用」，搜索ClawPanel，点击「卸载」
- 或通过「控制面板」→「程序」→「卸载程序」完成
清理残留数据（可选）：
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 |
# 清理应用数据（可选） rm -rf ~/.local/share/com.clawpanel.app rm -rf ~/.config/com.clawpanel.appLinux Web 版卸载五步法
sudo systemctl stop clawpanel sudo systemctl disable clawpanel sudo rm -f /etc/systemd/system/clawpanel.service sudo systemctl daemon-reload sudo rm -rf /opt/clawpanel如需彻底清理：
sudo npm uninstall -g @qingchencloud/openclaw-zh rm -rf ~/.openclaw⚠️ 最后一步会删除所有OpenClaw 配置（API Key、模型设置、Agent 记忆等），请确认不再需要后再执行。
Docker 卸载
docker stop clawpanel && docker rm clawpanel docker rmi $(docker images --filter "reference=*clawpanel*" -q) 2>/dev/null docker volume rm clawpanel-data # 可选，删除后所有配置丢失升级与卸载常见问题 FAQ
Q：升级后数据会丢吗？不会。ClawPanel 的配置、备份与 Agent 数据都存放在~/.openclaw/（Docker 为挂载卷clawpanel-data），覆盖安装只替换程序本体。
Q：面板版本和 OpenClaw 版本需要匹配吗？需要。ClawPanel 会按面板版本绑定一组推荐 OpenClaw 稳定版（策略文件见 openclaw-version-policy.json），可在「服务管理」页一键切换，避免老面板管理新版引擎带来的兼容性风险。
Q：前端热更新包能用于 Web 服务器吗？不能。frontend-hot-update-x.y.z.zip只供桌面端热更新兼容链路（清单见 docs/update/latest.json）；Web 服务器升级必须使用完整 Web 包，前端与 Node 后端同步替换。
Q：如何确认当前版本？桌面版看「关于」页；Web 版执行node -p "require('./package.json').version"；Docker 版查看容器内/app/package.json。版本号以package.json为唯一真相源，由 scripts/sync-version.js 同步到 Tauri 配置。
总结
- 桌面版升级认准「关于」页检查更新 + 覆盖安装，卸载走系统卸载器
- Web 版优先用一键升级脚本，手动升级务必前后端同版本
- Docker 版通过重建镜像升级，数据卷保留即不丢配置
- 卸载前想清楚
~/.openclaw数据目录：保留则配置可复用，删除则彻底清零
掌握这份 ClawPanel 升级与卸载清单，无论是日常版本管理还是彻底清理，都能快速、安全地完成。
【免费下载链接】clawpanel🦞 OpenClaw & Hermes Agent 多引擎 AI 管理面板 — 内置 AI 助手（工具调用 + 图片识别 + 多模态），一键安装 | Tauri v2 跨平台桌面应用 | 11 种语言项目地址: https://gitcode.com/qingchencloud/clawpanel
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
