GithubBackup/clawpanel
1
0
Fork 0
mirror of https://github.com/qingchencloud/clawpanel.git synced 2026-05-06 20:02:49 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs(readme): 新增升级/卸载教程 + 更新致谢列表

Browse Source 
- 新增「升级面板」章节：macOS/Windows/Linux 桌面版、Linux Web 版、Docker 五种场景
- 新增「卸载面板」章节：五种场景完整卸载步骤，含数据清理警告
- 代码贡献者新增 octo-patch(#163)、SEVENTEEN-TAN(#161)、roc-xie(#162)
- 社区反馈者新增 17 位近期 Issue 提交用户
This commit is contained in:
晴天
2026-03-30 23:59:54 +08:00
parent f5d32c377c
commit 57b8b25946
1 changed files with 209 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

209
README.md
View File

@@ -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
```
---
## 功能特性
<p align="center">
@@ -762,6 +949,11 @@ ClawPanel 的成长离不开每一位贡献者的付出。感谢你们让这个
<td align="center"><a href="https://github.com/0xsline"><img src="https://github.com/0xsline.png?size=80" width="60" height="60" style="border-radius:50%"><br><sub><b>0xsline</b></sub></a><br><a href="https://github.com/qingchencloud/clawpanel/pull/15">#15</a></td>
<td align="center"><a href="https://github.com/jonntd"><img src="https://github.com/jonntd.png?size=80" width="60" height="60" style="border-radius:50%"><br><sub><b>jonntd</b></sub></a><br><a href="https://github.com/qingchencloud/clawpanel/pull/18">#18</a></td>
</tr>
<tr>
<td align="center"><a href="https://github.com/octo-patch"><img src="https://github.com/octo-patch.png?size=80" width="60" height="60" style="border-radius:50%"><br><sub><b>octo-patch</b></sub></a><br><a href="https://github.com/qingchencloud/clawpanel/pull/163">#163</a></td>
<td align="center"><a href="https://github.com/SEVENTEEN-TAN"><img src="https://github.com/SEVENTEEN-TAN.png?size=80" width="60" height="60" style="border-radius:50%"><br><sub><b>SEVENTEEN-TAN</b></sub></a><br><a href="https://github.com/qingchencloud/clawpanel/pull/161">#161</a></td>
<td align="center"><a href="https://github.com/roc-xie"><img src="https://github.com/roc-xie.png?size=80" width="60" height="60" style="border-radius:50%"><br><sub><b>roc-xie</b></sub></a><br><a href="https://github.com/qingchencloud/clawpanel/pull/162">#162</a></td>
</tr>
</table>
### 🐛 社区反馈者
@@ -837,6 +1029,23 @@ ClawPanel 的成长离不开每一位贡献者的付出。感谢你们让这个
<a href="https://github.com/aliceQWAS"><img src="https://github.com/aliceQWAS.png?size=40" width="32" height="32" title="aliceQWAS"></a>
<a href="https://github.com/qingdeng888"><img src="https://github.com/qingdeng888.png?size=40" width="32" height="32" title="qingdeng888"></a>
<a href="https://github.com/18574707971"><img src="https://github.com/18574707971.png?size=40" width="32" height="32" title="18574707971"></a>
<a href="https://github.com/yushu200403"><img src="https://github.com/yushu200403.png?size=40" width="32" height="32" title="yushu200403"></a>
<a href="https://github.com/fakers777"><img src="https://github.com/fakers777.png?size=40" width="32" height="32" title="fakers777"></a>
<a href="https://github.com/carlyle168"><img src="https://github.com/carlyle168.png?size=40" width="32" height="32" title="carlyle168"></a>
<a href="https://github.com/jx270417948"><img src="https://github.com/jx270417948.png?size=40" width="32" height="32" title="jx270417948"></a>
<a href="https://github.com/wanababy"><img src="https://github.com/wanababy.png?size=40" width="32" height="32" title="wanababy"></a>
<a href="https://github.com/lwsg1987"><img src="https://github.com/lwsg1987.png?size=40" width="32" height="32" title="lwsg1987"></a>
<a href="https://github.com/xiaochengshiguduo"><img src="https://github.com/xiaochengshiguduo.png?size=40" width="32" height="32" title="xiaochengshiguduo"></a>
<a href="https://github.com/caofakun"><img src="https://github.com/caofakun.png?size=40" width="32" height="32" title="caofakun"></a>
<a href="https://github.com/adam479"><img src="https://github.com/adam479.png?size=40" width="32" height="32" title="adam479"></a>
<a href="https://github.com/WHHGR"><img src="https://github.com/WHHGR.png?size=40" width="32" height="32" title="WHHGR"></a>
<a href="https://github.com/z1a2q3wolf"><img src="https://github.com/z1a2q3wolf.png?size=40" width="32" height="32" title="z1a2q3wolf"></a>
<a href="https://github.com/kof8855"><img src="https://github.com/kof8855.png?size=40" width="32" height="32" title="kof8855"></a>
<a href="https://github.com/zshaxy"><img src="https://github.com/zshaxy.png?size=40" width="32" height="32" title="zshaxy"></a>
<a href="https://github.com/l15514559690-cmd"><img src="https://github.com/l15514559690-cmd.png?size=40" width="32" height="32" title="l15514559690-cmd"></a>
<a href="https://github.com/waicyz2009"><img src="https://github.com/waicyz2009.png?size=40" width="32" height="32" title="waicyz2009"></a>
<a href="https://github.com/y864261947"><img src="https://github.com/y864261947.png?size=40" width="32" height="32" title="y864261947"></a>
<a href="https://github.com/xcrossed"><img src="https://github.com/xcrossed.png?size=40" width="32" height="32" title="xcrossed"></a>
> 如果遗漏了你的贡献，请 [提交 Issue](https://github.com/qingchencloud/clawpanel/issues/new) 告知我们，我们会第一时间补充！