ClawPanel 升级与卸载全指南桌面版、Web版与Docker版本管理完整清单【免费下载链接】clawpanel OpenClaw Hermes Agent 多引擎 AI 管理面板 — 内置 AI 助手工具调用 图片识别 多模态一键安装 | Tauri v2 跨平台桌面应用 | 11 种语言项目地址: https://gitcode.com/qingchencloud/clawpanelClawPanel 是 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后运行DEBsudo dpkg -i ClawPanel_最新版本_amd64.debRPMsudo rpm -U ClawPanel-最新版本-1.x86_64.rpmWeb 版升级一键脚本与手动 git pullWeb 版部署在 Linux 服务器上默认访问地址为http://服务器IP:1420。最快升级方法一键升级脚本系统级安装/opt/clawpanelcurl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | sudo bash普通用户安装~/.local/share/clawpanelcurl -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会自动核对前后端版本不一致会停止加载升级后浏览器仍显示旧页面时按CtrlF5强制刷新国内网络拉取失败时可把 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-zhlatest --registry https://registry.npmmirror.com完整的 Compose 配置、自定义 Dockerfile 与 Nginx 反向代理方案见 docs/docker-deploy.mdCompose 示例参考 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.appLinux 桌面版卸载格式卸载命令AppImage直接删除.AppImage文件即可DEBsudo dpkg -r clawpanelRPMsudo 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 # 可选删除后所有配置丢失升级与卸载常见问题 FAQQ升级后数据会丢吗不会。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.jsonWeb 服务器升级必须使用完整 Web 包前端与 Node 后端同步替换。Q如何确认当前版本桌面版看「关于」页Web 版执行node -p require(./package.json).versionDocker 版查看容器内/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），仅供参考