卸载与清理
指导你如何安全地卸载 OpenClaw，并彻底清理相关配置数据、系统服务和容器环境
本指南将帮助你完整卸载 OpenClaw 及其相关数据。根据你的最初安装方式，请选择对应的卸载与清退方法。
📋 卸载前须知
数据备份
在卸载前，如果之后可能重新使用，建议先行备份以下重要数据：
# 备份配置文件 (Linux / macOS)
cp -r ~/.openclaw ~/openclaw-backup
# Windows 平台下备份
xcopy %USERPROFILE%\.openclaw %USERPROFILE%\openclaw-backup /E /I需要清理的内容清单
OpenClaw 产生的核心文件主要分布在以下位置：
| 类型 | 位置 | 说明 |
|---|---|---|
| 可执行文件 | npm 全局安装包目录 | OpenClaw 二进制命令入口 |
| 配置状态 | ~/.openclaw/ | 核心配置、密钥、记忆区 |
| 缓存文件 | ~/.openclaw/cache/ | 模型读取的各种临时缓存数据 |
| 技能文件 | ~/.openclaw/skills/ | 主动安装的第三方扩展插件技能 |
| 运行日志 | ~/.openclaw/logs/ | 历史执行日志与应用报错 |
| 守护进程 | 系统服务目录 (如 systemd或launchd) | 驻留后台服务的挂脚本配置 |
🖥️ 本地安装环境卸载
方法一：使用 npm 命令（最推荐）
1. 停止当前 OpenClaw 运转
# 停止所有 OpenClaw 被挂起的进程
openclaw stop
# 或者手动查找并无情终止它
# Linux / macOS:
ps aux | grep openclaw
kill -9 <找到的进程ID>
# Windows:
tasklist | findstr openclaw
taskkill /F /PID <找到的进程ID>2. 全局卸载 CLI 指令包
# 从包管理器全局卸载
npm uninstall -g openclaw
# 验证效果（现在应当报错或提示找不到）
openclaw --version3. 清理沙盒配置和残留数据
Linux / macOS 用户：
# 删除主工作区配置目录
rm -rf ~/.openclaw
# 删除相关独立缓存目录（如有）
rm -rf ~/.cache/openclaw
rm -rf ~/.local/share/openclawWindows 用户 (PowerShell)：
# 强制横扫主配置区
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw
# 抹除隐藏的应用缓存映射数据
Remove-Item -Recurse -Force $env:APPDATA\openclaw
Remove-Item -Recurse -Force $env:LOCALAPPDATA\openclaw4. 删除依附的系统守护服务
如果你曾经执行过 --install-daemon 安装了系统常驻程序，请一并清理：
Linux (systemd):
# 关停并取消自启授权
sudo systemctl stop openclaw
sudo systemctl disable openclaw
# 抹除进程挂画脚本文件
sudo rm /etc/systemd/system/openclaw.service
# 更新加载 systemd 表单
sudo systemctl daemon-reloadmacOS (launchd):
# 重载注销服务
launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
# 毁灭守护描述物
rm ~/Library/LaunchAgents/com.openclaw.plistWindows (系统服务面板):
# 请务必以管理员身份运行此批处理
sc stop OpenClaw
sc delete OpenClaw方法二：极客手动彻底斩除
如果你发现 npm 被破坏导致卸载脚本失败，祭出最后的撒手锏：
1. 捕获真身隐匿位置
# Linux / macOS 寻踪
which openclaw
npm root -g
# Windows 控制台探路
where openclaw
npm root -g2. 直接粉碎它的全量代码体
# Linux / macOS 下杀无赦
sudo rm -rf $(npm root -g)/openclaw
sudo rm $(which openclaw)
# Windows 强拆大队 (需要管理员身份运行)
Remove-Item -Recurse -Force "$(npm root -g)\openclaw"3. 甩掉安装包缓存
npm cache clean --force🐳 Docker 部署容器抹杀方案
关闭并摧毁运行时容器
# 打停运作的沙盒容器
docker stop openclaw
# 对容器毁尸灭迹
docker rm openclaw
# 直接删原版的公会公共库镜像
docker rmi ghcr.io/openclaw/openclaw:latest
# 一网打尽那些散落的零碎旧版大块头镜像
docker images | grep openclaw | awk '{print $3}' | xargs docker rmi扬了挂载的数据盘（数据卷）
# 排查你起过的 OpenClaw 卷名
docker volume ls | grep openclaw
# 定向删除你的对应卷
docker volume rm openclaw_data
# 或者粗暴点，清空所有游离没爹妈要的废弃卷筒
docker volume pruneDocker Compose 合成兽卸载
如果在用编排文件的话：
# 就地停止连根拔起对应容器、专用网络组与临时数据卷
docker-compose down -v
# 顺道也把底层打包镜像扫掉
docker-compose down --rmi all☁️ 服务器云端销户
腾讯云轻量应用服务器管理
A路线：原地重装做清零重置（保留这台机器续用）
- 登录腾讯云控制台。
- 切入轻量应用服务器（Lighthouse）的设备管理页中找对应实例。
- 点击服务器「重置应用」或者「重装系统」。
- 挑选其它新版的原始系统盘（如纯净 Ubuntu）直接将其覆盖写入还原。
B路线：跑路强制化作虚无（关停机器退费实例）
- 来到上述提到的服务器主面板页。
- 定位到当前卡片模块点击「更多操作」 → 「销毁/退还」。
- 阅览确认即刻抹杀释放。
⚠️ 注意事项：
- 点击销毁就如按了黑洞生成器，机器内的资料一瞬间永不再回。
- 未到期的提前退出可能要扣掉比例违约金或不予返还租金。
- 你好不容易绑定的静态公有IP地址也将保不住被放回公有回收池中。
阿里云等其他 ECS 云服务器
云端机器的大底大同小异，直接进入对应的工作台，选择强制释放/终止对应实例单元。顺手如果曾经勾选上了镜像和快照创建选项快照的，最好一并跑到快照列表触发「DeleteSnapshot」。
🧹 卸载终极自查清单
执行了所有清理工作后，我们需要对环境最后复核检验成果：
1. 探寻命令残留
openclaw --version
# 控制台反馈 "command not found" 即意味着主体二进制已清理消亡2. 刺探默认沙盒目录生还情况
# 探查 Unix
ls -la ~/.openclaw如果系统提示不能找到目录，说明痕迹已完全抹除。
3. 给僵尸监听端口上香
# 看看 18789 这个常驻端口是不是终于清静释放了
# Unix 查岗
lsof -i :18789
netstat -an | grep 18789❓ 常见卸载疑难杂症 (FAQ)
Q1: 删都老半天了，发现进程列表里还有它的残躯在冒红字运行？
A: 可能是一些守护僵尸进程没拔干净，补多两枪致命的：
# Linux / macOS 强制射击断头台
pkill -9 openclaw
# Windows 面板物理终止
taskkill /F /IM openclaw.exeQ2: 报错，一直死活不给我删主配置目录 Permission Denied ？
A: 那必然是安装时或者某次手滑用了最高权限，别手软，套上特权硬推土机开过去：
sudo rm -rf ~/.openclawQ3: 只是想临时取消运行状态保留配置以后再用？
A: 那你只需要敲下退下包卸载指令 npm uninstall -g openclaw，绝不碰 rm -rf ~/.openclaw 半指即可。它静静躺在用户录下，直到下回装上 CLI 会如数恢复。
Q4: 怎么针对性卸载大盘里的其中某一个具体的破烂技能插件？
A: 别用直接删目录的土法，使用它集成的 CLI 生态管理器：
openclaw skill uninstall <我不想要的技能注册名称>👋 写在最后
💡 如果因为遇到了什么诡异不可名状的报错又解决不了时才使用如此绝招气愤进行卸载，请记得还可以去 GitHub 提问讨论区 喊一喊开发组成员抢修。我们非常不希望这就是彼此旅途的尽头~