彻底卸载OpenClaw：进程、配置、Docker数据卷一网打尽

如果你电脑上装过 OpenClaw（就是大家常说的“龙虾”），应该能感受到它是个相当能折腾的 AI 智能体框架——接微信、挂网关、调度各种模型，确实好玩。但等你想卸载的时候，才是真正头疼的开始：命令行里敲which openclaw已经没输出了，磁盘上却还能翻出一堆.openclaw目录；docker ps -a看不到容器了，数据卷里却还躺着好几个 G 的旧数据；Windows 上那种离线整合包更离谱，AppData 里的配置可能比解压目录还大。这篇文章不聊怎么装，只讲怎么把它彻底卸干净。我会从进程、配置、Docker 三个维度整理三大核心技巧，再给一套完整的实操命令，适合所有装过 OpenClaw、现在想清理干净或者准备重装的朋友。

1. 动手前先看清家底：OpenClaw 的三种常见安装形态

在真正执行清理之前，先花两分钟搞清楚一件事：你当初是用什么方式把 OpenClaw 装上的？这决定了它把文件撒在了哪些地方。不同安装方式的“残留分布”完全不同，连自己属于哪种都没弄明白，后面很容易漏删，甚至会误删别的软件文件。

1.1 源码或脚本安装的内部状况：目录、服务、PATH 一个都不少

OpenClaw 官方安装脚本支持从 GitHub 的 main 分支直接检出源码，默认会拉到用户目录下的~/openclaw，然后在里面执行依赖安装。这种安装方式最典型的特征就是：没有走系统包管理器，所以你打开“程序列表”或者用dpkg、rpm根本查不到它，卸载必须手动来处理。

源码安装模式下，至少会在四个位置留下痕迹。首先是源码目录本身，就是~/openclaw或者你当初指定的目录，里面包含package.json、node_modules、src等等；其次是配置目录，常见的有~/.openclaw，存的是网关配置、模型参数、日志、会话缓存；再次是命令行工具，如果安装脚本顺手把@openclaw/cli之类的包装到了全局，那么which openclaw会有输出；最后是服务文件，如果你安装时选择了注册服务，那么 systemd 的 user 级或者系统级目录下会多出openclaw.service。

为什么说这种形态残留最让人头大？因为它就像出差住酒店时把随身物品摊满了整个房间——充电器在床头、洗漱包在浴室、文件散在书桌上，退房时总觉得收拾干净了，一回头还是会落下东西。手动卸载时如果漏掉任何一处，下次重装就可能出现“配置已存在”或者端口冲突。

1.2 Docker 方式隐蔽最深：容器、镜像、数据卷要分清

Docker 部署是 OpenClaw 玩家非常常用的方式，一条docker run或docker compose up -d就能把网关跑起来。好处是环境隔离、升级方便，但卸载时可就没那么轻松了。因为 Docker 把一个应用拆成了几个对象：容器、镜像、数据卷、网络。

用生活化的方式解释：容器是送货上门的“快递盒”，镜像是盒子里那套“说明书和包装模板”，数据卷是放在库房里的“储物柜”，里面存着聊天记录、数据库、配置。很多人卸载时只把快递盒扔了——docker rm删掉了容器，但储物柜没人去动，几个 G 的数据就那么继续躺在磁盘里。

所以如果当初你是用 Docker 跑的 OpenClaw，清理时必须把容器、镜像、数据卷、网络全部过一遍。尤其要注意，docker compose down默认不会删除数据卷，只有加了-v参数才会连卷一起删。这是一个非常容易踩的坑，后面实操部分我会再强调。

1.3 Windows 整合包方式：解压目录和 AppData 都藏了东西

这几年国内社区经常出现“OpenClaw 离线整合包”这类资源，解压即用，自带 Node.js、Python 等运行时。这种整合包最大的迷惑性在于：你觉得自己只是“解开了一个文件夹”，卸载时把文件夹拖进回收站就算完事。实际上它首次运行时，会在%APPDATA%或%LOCALAPPDATA%下生成数据目录，有些整合包还会在“启动”文件夹、任务计划程序或者注册表 Run 键里挂上开机自启。

更麻烦的是，这类整合包有时候会内嵌一个独立的 Node 或 Python 运行时。即使你把主程序目录删了，如果它注册了系统 PATH，命令行里敲某些命令还是会碰见它。所以 Windows 整合包用户的清理清单里，必须包含四块：解压目录、AppData 下的数据目录、开机启动项、环境变量。只看“应用和功能”列表是远远不够的，因为免安装绿色包根本不会出现在那个列表里。

2. 三大核心技巧：从进程到数据卷的无死角清理

看懂了自己属于哪种安装方式之后，就可以按照下面的三大技巧动手了。这三个技巧对应的其实是一条完整清理链路：先让程序彻底停转，再删配置和登录态，最后清掉 Docker 和缓存。顺序不能乱，因为进程不先停掉，后面删文件大概率会失败。

2.1 技巧一：先“按住”所有相关进程和服务，让系统安静下来

很多人一上来就直接删目录，结果收到“文件正在使用中”的弹窗，然后才开始找进程、杀进程，白白折腾半天。正确的做法是，动手之前先把所有和 OpenClaw 相关的进程停掉。

Linux/macOS 下，先检查 systemd 服务里有没有注册 OpenClaw：

systemctl list-units --all | grep -i openclaw systemctl --user list-units --all | grep -i openclaw

如果有输出，就执行停止和禁用：

sudo systemctl stop openclaw sudo systemctl disable openclaw systemctl --user stop openclaw systemctl --user disable openclaw

然后留意独立进程：

ps aux | grep -i openclaw ps aux | grep -i node | grep -i openclaw

发现残留进程后用kill -9 PID处理。Windows 用户同理，打开任务管理器，结束OpenClaw.exe、node.exe、python.exe相关进程。有部分玩家是用 pm2 管理网关进程的，记得pm2 list看一眼，没有直接关系但顺手处理掉更干净。

有一个细节容易被忽视：如果你配置过微信插件或者用了 ilinkai 网关，后台可能挂着名称里没有“openclaw”字样的进程，检测这类隐藏进程最靠谱的办法是查端口。打开你之前配置过的网关端口，用lsof -i :端口（macOS/Linux）或者netstat -ano | findstr 端口（Windows）查看占用情况，发现 PID 之后先看进程名，确认是 OpenClaw 相关再杀掉，避免误杀其他服务。

2.2 技巧二：清除配置目录、登录态与缓存，这是残留的大本营

进程停掉之后，接下来要清理的是配置文件和数据目录。我建议在删之前先做一次“探路”，因为不同版本、不同安装脚本产生的路径可能有差异。用find或者系统搜素先定位一下：

find ~ -maxdepth 3 -iname "*openclaw*" 2>/dev/null

在 Linux/macOS 上，常见的位置有这些：

Windows 上常见的路径是%USERPROFILE%\.openclaw、%APPDATA%\OpenClaw、%LOCALAPPDATA%\OpenClaw。其中%APPDATA%里通常存的是应用配置和缓存，%LOCALAPPDATA%里则可能是本地数据库或日志。如果你用的是离线整合包，还要回到解压目录本身，把整个文件夹删掉。

删配置目录的同时，千万别忘了环境变量。OpenClaw 安装时可能写入了OPENCLAW_HOME、OPENCLAW_GATEWAY、OPENCLAW_MODEL之类的变量，也可能在 PATH 里加过一个目录。查看方法：

env | grep -i openclaw echo $PATH | tr ':' '\n' | grep -i openclaw

确认之后，去~/.bashrc、~/.zshrc或~/.profile里删掉对应行，然后source一下让配置生效。Windows 用户则要到“系统属性 -> 环境变量”里手动清理。这一步很多人会漏，后果是重装新版 OpenClaw 后，系统还在用旧的环境变量指向已经不存在的位置，导致各种莫名奇妙的启动报错。

2.3 技巧三：清掉 Docker 与运行时缓存，空间释放的关键一步

如果你曾经用 Docker 跑过 OpenClaw，这一节绝对不能跳过。先看几个关键命令：

# 查看所有容器，确认是否存在 openclaw 相关 docker ps -a --filter "name=openclaw" # 强制删除容器 docker rm -f $(docker ps -aq --filter "name=openclaw") # 查看并删除镜像 docker images | grep -i openclaw docker rmi -f $(docker images | grep -i openclaw | awk '{print $3}') # 查看并删除数据卷 docker volume ls | grep -i openclaw docker volume rm $(docker volume ls -q | grep -i openclaw) # 查看并删除网络 docker network ls | grep -i openclaw docker network rm $(docker network ls -q | grep -i openclaw) 2>/dev/null # 清理构建缓存 docker builder prune -f

我遇到过不少朋友只删了容器和镜像，然后跑来问我“为什么磁盘空间没释放多少”。这类情况九成是数据卷还在。Docker 的数据卷设计初衷是持久化数据，所以它不会因为容器删除就自动消失。你必须主动docker volume rm，或者当初用 compose 时在down命令后加-v参数（docker compose down -v），才能把卷一并带走。

还有一个小众但值得注意的点：如果你在 compose 文件里用了 bind mount（宿主机目录直接映射，比如./data:/root/.openclaw），那么数据卷命令里看不到它，必须自己去宿主机映射的目录里删。另外，如果安装 OpenClaw 时附带过 Python 虚拟环境或 Conda 环境，这些依赖占用的体积也不小，定位到对应目录后一并删除。最后可以用docker system df查看清理后的资源占用，确认 Space 已经回收。

3. 逐步实操记录：以 Docker 部署为例的完整卸载流程

这一节是把上面的技巧串起来，给出一套可以“直接抄作业”的完整流程。为了演示方便，我以最常见的 Docker Compose 部署方式为例。如果你是用源码或整合包装的，也不用慌，流程结构完全一致，把其中 Docker 相关步骤替换成对应的目录删除即可。

3.1 动手前先确认安装方式，并决定是否备份

执行卸载之前，先花 30 秒确认安装方式。三个命令就能判断：

docker ps -a | grep -i openclaw # 有输出说明是 Docker 方式 which openclaw # 有输出说明装着 CLI 命令 find ~ -maxdepth 2 -iname "*openclaw*" 2>/dev/null # 找配置目录

如果还想保留数据（比如你以后可能要重装、或者想把某个 Skill 技能迁移到别的环境），现在是最好的备份时机。需要备份的资料主要是三个部分：配置文件（网关地址、模型列表、API Key）、skills目录、以及聊天记录或会话文件。执行：

tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw 2>/dev/null

备份文件里包含密钥类信息，建议存到安全位置，不要传到公共网盘。如果你已经决定彻底弃用 OpenClaw，那就不用备份了，清理得越干净越好——之前导出的 API Key 建议直接作废重建，防止配置散落。

3.2 分步执行卸载命令：一条条对着抄

确定不再需要保留数据后，按照下面的顺序依次执行。以 Linux/macOS 为例：

# 1. 停止并禁用服务 sudo systemctl stop openclaw 2>/dev/null sudo systemctl disable openclaw 2>/dev/null systemctl --user stop openclaw 2>/dev/null systemctl --user disable openclaw 2>/dev/null # 2. 停止并删除 Docker 容器 docker ps -a --filter "name=openclaw" docker rm -f $(docker ps -aq --filter "name=openclaw") # 3. 删除 Docker 镜像 docker images | grep -i openclaw docker rmi -f $(docker images | grep -i openclaw | awk '{print $3}') # 4. 删除 Docker 数据卷和网络 docker volume ls | grep -i openclaw docker volume rm $(docker volume ls -q | grep -i openclaw) docker network ls | grep -i openclaw docker network rm $(docker network ls -q | grep -i openclaw) 2>/dev/null # 5. 删除 systemd 服务文件 sudo rm -f /etc/systemd/system/openclaw*.service rm -f ~/.config/systemd/user/openclaw*.service sudo systemctl daemon-reload # 6. 删除源码、配置和缓存目录 rm -rf ~/openclaw ~/.openclaw ~/.config/openclaw rm -rf ~/Library/Application\ Support/OpenClaw # 7. 清理环境变量（先查看，再手动编辑 ~/.bashrc 或 ~/.zshrc） env | grep -i openclaw echo $PATH | tr ':' '\n' | grep -i openclaw

Windows 用户参考下面的 PowerShell 命令（需要用管理员权限运行）：

# 1. 结束进程 Get-Process | Where-Object { $_.ProcessName -like '*openclaw*' } | Stop-Process -Force # 2. 删除配置目录 Remove-Item -Path "$env:USERPROFILE\.openclaw" -Recurse -Force -ErrorAction SilentlyContinue Remove-Item -Path "$env:APPDATA\OpenClaw" -Recurse -Force -ErrorAction SilentlyContinue Remove-Item -Path "$env:LOCALAPPDATA\OpenClaw" -Recurse -Force -ErrorAction SilentlyContinue # 3. 如果有 Docker 相关容器和镜像，同样执行删除 docker ps -a --filter "name=openclaw" docker rm -f $(docker ps -aq --filter "name=openclaw") # 4. 删除桌面和开始菜单快捷方式 Remove-Item "$env:PUBLIC\Desktop\OpenClaw*.lnk" -Force -ErrorAction SilentlyContinue Remove-Item "$env:USERPROFILE\Desktop\OpenClaw*.lnk" -Force -ErrorAction SilentlyContinue Remove-Item "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\OpenClaw*" -Recurse -Force -ErrorAction SilentlyContinue

第三步之后，如果还担心整合包注册过开机自启，可以去“任务计划程序”里搜一下 openclaw，有相关任务就右键禁用并删除。注册表层面，打开regedit，用“查找”功能搜openclaw，手动清除相关键值。这里强调一句，改注册表前建议先用系统还原点做一次备份，虽然 OpenClaw 留下的键不多，但注册表操作再怎么谨慎都不为过。

3.3 卸载后的体检清单：端口、进程、目录逐项确认

命令执行完，并不代表真的干净了。“卸载后体检”这一步，我建议按下面这个清单逐项过一遍：

体检完成之后，最好重启一次系统。重启的意义在于：第一，确认没有开机自启的服务试图把 OpenClaw 再次拉起来；第二，Windows 系统删除文件后，重启能释放所有文件句柄，把最后那点“残影”清掉。尤其是 Windows 离线整合包用户，不重启很难发现某些 DLL 还挂在某一个进程里。

4. 常见问题与排查技巧实录

这部分是我在实操里经常被问到的典型问题，同时也是自己踩过的坑，整理成速查式的内容，方便大家定位。

4.1 明明全部删完了，端口还是被占用怎么办

先别急着杀进程，因为占端口的不一定是 OpenClaw。常见情况有三种：一是某个 node 网关进程没有被杀掉，端口还握着不放；二是 Docker 容器删了但网络没清理，旧端口映射还在；三是你的网关端口恰好和另一个服务重叠，比如 3838 也被其他工具占用。

排查命令先上：

lsof -i :3838 # macOS/Linux netstat -ano | findstr 3838 # Windows

拿到 PID 后，用ps -p PID看一下进程名。确认是 node 或者 openclaw 相关的进程，再执行kill -9 PID。如果进程名是不认识的其他程序，别乱杀，说不定那本来就是你系统里在跑的服务。这里我的习惯是：先重启一次，很多残留进程会在退出时自动释放端口，重启后端口若还被占，再考虑手动清理。

4.2 Windows 下目录删不掉：文件被占用、权限不足、路径太长

Windows 删除 OpenClaw 配置目录失败，几乎都是这三个原因。文件被占用最好解决，先回任务管理器把所有 node、python、openclaw 相关进程结束后再删。权限不足就需要管理员权限执行，部分目录可能还要先取得所有权：

# 用管理员权限 PowerShell 执行，先获取所有权再强删 takeown /f "C:\Users\你的用户名\.openclaw" /r /d y icacls "C:\Users\你的用户名\.openclaw" /grant 你的用户名:F /t /c rmdir /s /q "C:\Users\你的用户名\.openclaw"

如果是因为路径太长导致的报错，最简单的办法是先用文件管理器进入上一层目录，把整个父文件夹拖到磁盘根目录附近（比如C:\下），再重新执行删除，路径长度缩短后一般就能删掉。我遇到过几次，这类小问题往往比清理本身更耗时，放在最后处理心态会好很多。

4.3 Docker 数据卷删不掉或删除时报错

docker volume rm报错，绝大多数原因是还有容器在引用这个卷，即使容器已经是 Exited 状态也一样。解决办法很简单：先删所有引用该卷的容器，再删卷。如果你确定这个卷已经无用，也可以用docker volume prune -f清理所有未被引用的匿名卷。

如果数据卷是具名卷，但docker volume rm一直提示占用，可以用docker ps -aq --filter "volume=卷名"找出引用容器，手动docker rm -f后再执行删除。这里不建议一上来就docker system prune -a --volumes，因为这个命令会一口气清空所有未使用的镜像、容器、网络和卷，如果你的机器上还跑着其他 Docker 项目，很可能会被误伤。

4.4 重装 OpenClaw 时报“配置已存在”或端口冲突

这种情况十有八九是历史残留没有清干净。最典型的是~/.openclaw目录还在，新版本启动时读到旧配置，直接拒绝初始化；或者旧的 systemd 服务文件还在，安装脚本检测到端口被占用就自动跳过了启动步骤。

处理方法就是走一遍第 3 章的体检清单，把配置目录、环境变量、服务文件、Docker 数据卷全部确认一遍。如果你配置过 Nginx 或 Caddy 反向代理指向 OpenClaw 网关，那还要把对应的站点配置一并删除或停用，否则重装后域名访问还是会指向旧配置，甚至出现 502 或 504 错误。

4.5 微信插件或 ilinkai 网关的会话残留

OpenClaw 接微信时，扫码登录后的认证信息、会话 token 通常会缓存在数据目录里。如果卸载时只删主程序，不删这些缓存文件，以后再装回来或者换个账号重连，很可能触发平台服务端的安全提醒，收到“异常登录”或“会话冲突”之类的提示。

处理办法是，决定卸载时先在 OpenClaw 里主动退出微信登录，再删除整个~/.openclaw或%APPDATA%\OpenClaw目录。如果已经卸载完了才发现这个问题，那就把数据目录整个删掉，包括session、auth、token相关文件。需要说明的是，本地缓存清理只能解决“本机残留”的问题，如果平台服务端已经因为异常行为触发了安全策略，那是平台侧的逻辑，卸载软件无法直接解除，只能等待平台自动恢复或按官方渠道申诉。

最后分享一个我自己的习惯。我以前卸载这类多形态框架时也吃过亏，删完源码目录以为完事了，过几天发现 systemd 还在尝试拉起服务，日志文件落了半个 G，命令行里偶尔还能蹦出几行 OpenClaw 的输出。后来我给自己定了一条规矩：先确认安装方式，再按“停进程、清配置、清容器卷、验环境变量”的顺序走一遍，完成后重启机器再复查一次。这套打法不仅对 OpenClaw 有效，对很多通过脚本、Docker 或集成包安装的智能体工具都适用。如果你也把龙虾装上又卸掉过，不妨按这个思路来一遍——只要进程、配置、数据卷这三关都守住，系统资源和磁盘空间就能真正回到自己手里。