OpenClaw 完全卸载指南：Windows/Linux 残留清理与避坑

写这篇东西之前，我先说个背景。OpenClaw 是目前圈子里挺火的 AI 代理编排工具，配合大模型应用开发、多智能体协作、自动化任务调度这些场景非常好用。但正因为它太"灵活"，安装方式五花八门——有二进制直放的、有 npm 全局安装的、有跑 Docker 容器里的、还有编译源码装的。结果就是：装的时候一时爽，卸载的时候欲哭无泪。

我最近刚好在一台 Windows 和一台 Linux 服务器上分别折腾了一次 OpenClaw 的卸载。说实话，这个工具卸载起来比我想象中麻烦不少，尤其是它默认会写一些隐藏配置、启动后台服务、往环境变量里加路径，再加上 Day 级别的交互数据、矢量索引文件，这些残留不只是占空间，还会在下次重新安装时产生莫名的冲突。我把完整的排查过程和卸载步骤整理出来，给你做个参考。

1. 卸载前的整体思路与准备工作

1.1 先搞清楚 OpenClaw 在你机器上是哪种形态

很多人大包大揽地直接删目录，结果发现删除不干净，就是这个原因——没有先弄清 OpenClaw 是以什么形态存在。

我按照常见的安装方式归纳了一下，大概分成四类：

一类是 Docker 容器部署。这类最"干净"，OpenClaw 的主体逻辑都在镜像里，你只要把容器停掉、镜像删掉、挂载的卷删掉，基本上就完事了。但难点在于，你得知道当时的映射卷目录在哪里，忘了就麻烦了。

二类是 npm 全局安装。很多人在 Ubuntu 或 Windows 上直接用npm install -g openclaw或npm install @openclaw/core -g这类命令装。这种安装会往全局 node_modules 里写文件，同时生成一个命令行入口。卸载时既要删 npm 全局包，又要处理可能的软链接文件。

三类是源码编译或免编译二进制包。把仓库 clone 下来，或者直接下载了 release 里面的预编译二进制，解压到/opt/openclaw、C:\OpenClaw之类的目录。这种通常还自带了 systemd unit 文件（Linux）或计划任务（Windows），卸载时不能只删主目录，还要处理这两个系统级的"挂载点"。

四类是辅助性的模型配置与网关管理工具。OpenClaw 通常会配合外部的大模型 API 网关，所以会在用户的配置文件目录里留一些 token、鉴权信息、路由配置。这些不算主体程序，但属于安全敏感信息，卸载时最好一并删除。

我建议卸载前先运行一次openclaw --version或oc --version，看一下命令入口、确认 CLI 能正常执行。如果命令都找不到了，说明程序主体可能已经删了，后面重点就变成了清理配置和系统残留。

1.2 卸载之前必须先做的三件小事

动手之前，先别急着敲命令。我在实际操作中总结出三个必须做的动作，每个都是踩过坑的教训，顺序很重要。

第一，备份当前会话数据。OpenClaw 里通常保存了历史对话、任务记录、工作流配置文件。如果你以后还会用到这个工具，或者想把这些数据迁移到其他机器上，最好先看一眼数据目录。一般情况下，它的配置在用户主目录下的.openclaw文件夹，或是~/.config/openclaw。我自己的习惯是直接打一个 tar 包，放到安全的位置，反正卸载完成后如果不需要再删掉就行。

第二，记录当前运行的服务状态。如果 OpenClaw 正在运行，直接卸载会带来一个很恶心的状态：程序文件删了，但后台进程还在跑，持续占内存。等到重启时又提示找不到模块。所以必须先停服务。在 Linux 上，我会先执行systemctl --type=service | grep claw或者ps aux | grep openclaw看进程。在 Windows 上会看服务列表或者任务管理器里的进程名。

第三，检查是否有自动启动任务。OpenClaw 在集成度较高时，会写入开机自启或者把常驻进程注册为系统服务。如果不停掉这个自动启动，就会形成一个"猫捉老鼠"的循环：删了文件，重启之后又自动拉起一个不完整的 OpenClaw，报错信息非常迷惑。

这步其实非常重要。我见过不少人说卸载不干净，真正的原因是没停掉基于 systemd 的常驻服务，系统又把二进制文件自动拉起来了。所以，卸载 OpenClaw 的首要原则就一句话：先停服务、再删文件、后清配置、最后查残留。

2. Windows 平台卸载 OpenClaw 的完整流程

2.1 用标准方式卸载已知部分

Windows 的卸载逻辑和 Linux 有比较大的差异。我推荐的思路是，先走"软件卸载的正常路径"，再去处理文件与注册表级别的残留。

第一步：通过应用列表卸载。按下Win + I打开设置，进入"应用"→"已安装的应用"，搜索栏里输入 OpenClaw 或 claw。如果能搜出来，说明它通过安装包（NSIS 或 MSI）写入过系统注册表，直接点卸载，按向导处理即可。

但这里有个细节，很多 OpenClaw 本体并不带图形安装界面，这个列表里找不到很正常。找不到不代表它没安装，只是它没走注册表这条路径而已。

第二步：停掉进程和计划任务。在 Windows 上，OpenClaw 在后台运行时，一般是node.exe进程承载的，也可能有独立的openclaw.exe。打开任务管理器，找到进程，右键结束任务。同时按下Win + R，输入taskschd.msc打开任务计划程序。仔细检查任务计划程序库，看有没有 OpenClaw 或 agent 相关的计划任务。选中有状态的，右键禁用或删除。

第三步：停止 Windows 服务。有些 pe 版本会使用nssm把代理进程注册成 Windows 服务。运行services.msc，查找名称里带 OpenClaw、claw-agent 字样的服务。找到后先停止，再把启动类型改为"禁用"。接着在管理员权限的命令行或 PowerShell 里执行删除：

sc.exe delete "OpenClawService"

把服务名替换成你实际看到的名字。这里有个常见误区：直接在 services.msc 里右键删除可能报"服务标记为删除"的错，用 sc.exe 删除更干净，而且能立刻生效。

2.2 手动清除 Windows 下的残留目录和环境变量

走到这一步，主体程序已经被"拆"得差不多了，接下来就是清理残留文件。

从路径角度看，OpenClaw 在 Windows 上会往这几个地方写数据，你可以逐一检查并删除：

• C:\Program Files\OpenClaw或C:\Program Files (x86)\OpenClaw：安装目录，程序主体所在。
• C:\Users\你的用户名\.openclaw：默认的用户数据目录，里面包含 session、会话历史、矢量索引。
• C:\Users\你的用户名\.config\openclaw：配置文件目录，有的版本会把配置放在这里。
• C:\Users\你的用户名\AppData\Roaming\openclaw：应用数据目录，包含日志、临时文件。
• C:\Users\你的用户名\AppData\Roaming\npm\node_modules下的openclaw相关包：如果你是通过 npm 全局安装的，就需要清理这个目录。
• C:\Users\你的用户名\AppData\Local\Temp下的临时文件，如果有以openclaw或claw命名的，手动删一下。

我实际清理的时候，路径里的一个坑是：OpenClaw 的配置目录散落在 Roaming 和用户主目录两个地方。如果你只是前面做了应用卸载，配置文件经常会漏掉。我的做法是直接在命令行搜索一遍：

Get-ChildItem -Path C:\Users\你的用户名 -Recurse -Force -ErrorAction SilentlyContinue | Where-Object { $_.Name -like "*openclaw*" -or $_.Name -like "*claw*" } | Select-Object FullName

这条 PowerShell 命令会列出所有与 openclaw 相关的路径，方便你识别哪些该删、哪些不该删。注意，搜索结果里可能包含工作文档里带 "claw" 的文件，你要自己判断一下，不要伤及无辜。

环境变量方面，重点检查两类。一类是 Path，里面可能有一项指向npm\node_modules\openclaw\bin或安装目录；另一类可能是OPENCLAW_HOME或CLAW_CONFIG_DIR。打开"系统属性"→"环境变量"，把对应的项删掉。不删的话，下次运行命令行还会看到"command not found"以外的诡异提示。

2.3 Windows 注册表清理的关键点与注意事项

这一步是最容易被忽略的部分，也是导致"卸载不干净"说法最多的来源。

OpenClaw 有些版本会写入以下注册表区域，你可以用注册表编辑器（regedit）搜索关键词：

• HKEY_CURRENT_USER\Software\OpenClaw
• HKEY_LOCAL_MACHINE\SOFTWARE\OpenClaw
• HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\OpenClaw

搜索方法：在注册表编辑器里按Ctrl + F，输入OpenClaw，逐个查找并删除。这里有个特别需要小心的点：只删除自己能确认的项，不要动那些可能是第三方软件或系统组件里的同名键值。比如我用Everything搜到一个无关的画图软件带 "claw" 字样，差点误删。所以对claw这个模糊关键词，我一向更谨慎，搜索时优先用完整的openclaw。

另外，注册表清理完以后，我不建议用各种"注册表清理大师"之类的工具自动清理。自己手动删可控性最高，也最安全。这种工具的批量扫描很容易误判，遇到过好几次因为误杀导致其他软件出问题的情况。

3. Linux 平台卸载 OpenClaw 的完整流程

3.1 停止 systemd 服务与检查运行状态

Linux 下的 OpenClaw 卸载，第一条铁律就是：先看 systemd 服务。很多网友在部署时图省事，直接用了网上的一键脚本，脚本里自动把 OpenClaw 注册成了openclaw.service或claw-agent.service，与系统同生共死。

我的排查顺序如下：

systemctl list-units --type=service | grep -i claw

如果列出了名字像openclaw或claw-agent的单元，先停掉再禁用：

sudo systemctl stop openclaw.service sudo systemctl disable openclaw.service

然后再去查看服务的 Unit 文件位置，把它删掉。一般在/etc/systemd/system/或/lib/systemd/system/下，可能是openclaw.service。删掉后重新加载一下 daemon，让系统感知变化：

sudo systemctl daemon-reload sudo systemctl reset-failed

如果不走 systemd，有些程序是直接用nohup或者pm2守护的。检查一下：

ps aux | grep openclaw pm2 list

对于 pm2 管理的，直接pm2 delete openclaw或对应名称。这一步做完，才能继续下面的目录清理。我见过有人没有做这个步骤直接删目录，结果进程还活着，日志目录里的句柄一直没释放，磁盘空间也没有真正归还。

3.2 通过包管理器卸载与程序目录删除

Linux 底下 OpenClaw 的安装方式决定了卸载命令。像我用过的几种情况，给对应的命令：

• 如果用 npm 装的按指定版本卸载（注意，一般都需要全局参数）：

sudo npm uninstall -g openclaw sudo npm uninstall -g @openclaw/core

• 如果是 apt 仓库安装的，先看包名：

dpkg -l | grep claw sudo apt remove openclaw

• 如果源码编译安装的，到编译目录里检查是不是提供了 uninstall 目标（大多数可能没有，需要手动删）：

sudo make uninstall

源码卸载不要抱太大希望。我在本地测试时，很多工具干脆没提供 uninstall 目标，make uninstall 执行完提示 nothing to be done，最后还是手动收尾。所以更可靠的方式是手动删目录。

手动删目录时，按优先级来看，这几个目录删除是重点：

sudo rm -rf /opt/openclaw sudo rm -rf /usr/local/lib/openclaw sudo rm -rf /usr/local/bin/openclaw sudo rm -rf /usr/lib/node_modules/openclaw

同时检查用户目录下的隐藏文件夹：

rm -rf ~/.openclaw rm -rf ~/.config/openclaw rm -rf ~/.local/share/openclaw rm -rf ~/.cache/openclaw

3.3 Linux 环境变量与 shell 配置的清理

环境变量往往是最容易被忽略的一层。OpenClaw 在 Linux 上安装后，可能会在~/.bashrc、~/.zshrc或/etc/profile里追加几行 PATH 导出或 OpenClaw 相关变量。

我建议先检查再删除：

grep -n "openclaw\|OPENCLAW\|claw" ~/.bashrc ~/.zshrc 2>/dev/null

找到相关行后，用编辑器删除或注释，然后刷新配置：

source ~/.bashrc

如果排查出全局/etc/profile或/etc/profile.d/下有 openclaw.sh 之类的文件，也一并删掉。不删的话，虽然主体已经卸载了，但 shell 初始化时还是会有报错提示，比如 command not found 或一些恶心的 undefined 错误。

还需要检查一个很容易漏掉的点：npm 的全局 bin 软链接。如果你用 npm 全局安装过 OpenClaw，删除 npm 包后，bin 目录里的软链可能还残留。看看：

ls -la /usr/local/bin/ | grep claw which openclaw

删掉对应的软链接。直接which openclaw如果返回空，基本说明命令行入口已清理干净。

3.4 Docker 部署形态的 OpenClaw 怎么卸载

如果在 Linux 上是用 Docker 那套方式装的，流程就变成 Docker 生态内的操作。先找到容器和镜像：

docker ps -a | grep openclaw docker images | grep openclaw

逐个删除容器，删除镜像，最后清理命名卷：

docker rm -f openclaw-container名 docker rmi openclaw镜像名 docker volume ls | grep openclaw docker volume rm openclaw卷名

最容易被忽略的是 Docker 卷。很多人删完容器和镜像，以为万事大吉了，结果数据卷还占着几个 GB 的空间。另外要检查一下有没有通过 docker-compose 部署的目录，一般会有一个独立的 compose 项目目录，比如~/openclaw或/srv/openclaw-docker，这个目录也要删掉。

Docker 部署的好处在于主体隔离存在容器里，宿主机上的文件残留特别少，只需要处理配置目录和代理网络的网关配置。但反向的坑是：如果你之前设置了 Docker 自启动时同步启动这个容器，那么容器删除了，compose 项目目录还在，下次一执行docker compose up又会把镜像拉起来。

4. 通用残留清理与验证卸载是否彻底

4.1 日志文件、临时文件与缓存目录排查

很多人卸载完 OpenClaw 后感觉"不干净"，问题大多出在残留的日志、临时和缓存文件上。

OpenClaw 这类大模型应用工具，在跑任务时时长会产生大量日志，特别是接入了多智能体调试环境之后，每个 agent session 都会生成一份独立的日志文件。日志里有时还记录了 API 调用链、提示词内容、模型响应摘要，这些属于敏感信息，卸载时要重点处理。

Linux 上的常见残留位置：

/var/log/openclaw/ /var/log/claw* /tmp/openclaw* /tmp/claw-audit-*.log

Windows 上的：

• C:\Windows\Temp\openclaw*
• C:\Users\用户名\AppData\Local\Temp\claw-*

删除之前，我的建议是看一眼日志内容。如果里面包含 API key、Token 之类的敏感信息，改一下相关的密钥配置，因为服务器上可能已经泄露了。这个细节你在官方文档里是看不到的，但作为一个有运维经验的人，换掉密钥比删掉日志更重要。

清理命令实例（Linux）：

sudo rm -rf /var/log/openclaw /tmp/openclaw* find /tmp -maxdepth 1 -name "claw*" -type f -mtime +1 -delete

4.2 网络层面的残留：代理网关与端口监听

OpenClaw 这个工具比较特殊，它不只是本地 CLI，更多时候是一个 agent 编排网关，会监听某个本地端口（常见的比如 1867、3000 之类，也可能是你自己配置的端口）。卸载前如果没停干净，端口会一直开着。

我建议卸载完成后，验证一下端口是否被监听：

sudo netstat -tunlp | grep -E ":1867|:3000|:1880"

Windows 上：

netstat -ano | findstr ":1867" tasklist /fi "pid eq 进程ID"

这个检查很有必要。端口监听状态能很直白地告诉你进程到底还在不在。如果端口还在监听，就说明有进程没有清理干净，继续用lsof -i :端口反查 PID，然后终止对应进程。

另外，有些高级部署场景中，OpenClaw 会配置外部 API 网关（比如内网共同管理模型密钥的网关）作为模型统一入口。卸载本地客户端不一定会影响这些网关上注册的 agent 规则，但涉及团队共用的网关，最好去确认一下该项目已从网关中移除ID、密钥是否已经回收。这个不在本地卸载范围内，但实际使用中一定会遇到。

4.3 如何验证 OpenClaw 真的卸载干净了

这一步是我自己总结的一套验证流程，实测下来覆盖度很高。不需要安装额外工具，就是利用系统原生命令检查几个维度：

命令行入口检查：

which openclaw command -v claw

如果返回空，说明主体程序入口已清理。

文件残留检查：

find / -name "*openclaw*" -o -name "claw-agent*" 2>/dev/null

Windows 上我用的命令是：

Get-ChildItem -Path C:\ -Recurse -Filter "*openclaw*" -Force -ErrorAction SilentlyContinue | Select-Object FullName

注意：这个扫描可能要花一点时间，建议针对重点目录扫描，不要全盘扫，容易扫出无关内容。

服务与进程对照检查：

systemctl status openclaw.service ps aux | grep openclaw

如果服务不存在、进程不存在，证明常驻部分已清理。在 Windows 上检查服务管理器已经没有 OpenClaw 条目。

网络端口对照检查：

像我上面提到的，检查之前 OpenClaw 使用的端口是否已经释放。如果在卸载前自己记录的端口是已知的，直接验证该端口已不被监听就行。

环境变量检查：

env | grep -i openclaw echo $OPENCLAW_HOME

Windows 上用set | findstr openclaw。

我个人的经验是，做到上面四步，这个卸载就可以宣告彻底干净了。

5. 卸载过程中遇到的常见问题与避坑技巧

5.1 典型高频问题排查速查表

我在实际操作中以及跟群友沟通时，整理出一份问题速查表，把高频的坑都列出来了：

这里的session file locked是比较有代表性的错误。我自己第一次遇到时，误以为删除文件就行，结果发现这个文件是被某个后台进程当成会话锁持有。OpenClaw 的多实例并发机制很特殊，如果前一个实例非正常退出，lock 文件不会自动释放，卸载完成后重新安装时就会反复报这个错。处理方式是要找到持有该锁的进程并终止，然后删除锁文件。

5.2 处理 OpenClaw 多用户部署或团队共享场景的特殊情况

如果你的 OpenClaw 部署在 Linux 服务器上，而且被多个用户共享（比如几个搞大模型应用开发的朋友一起调试 agent），情况会更复杂一点。

我有一次帮朋友处理的就是这种场景：服务器上有三个用户都装过 OpenClaw，其中两个用户是通过 npm 全局安装的，第三个用户是通过 Docker 跑的。这三个方案的残留，分布在完全不同的路径下。如果只清理 root 用户下的相关目录，另外两个用户下的命理符号范围内还有独立的配置文件。

这时候建议这样做：

• 在卸载前，先检查每个用户主目录下的.openclaw目录及.config/openclaw目录，分别确认空间大小。
• 查看全局环境变量，确认是否存在/etc/profile.d/下的 openclaw 配置。
• 处理完后，用last或进程检查确认没有其他用户还在运行 OpenClaw 进程。

另外一个容易忽视的地方是：OpenClaw 的 session 文件锁，错误日志里出现的agent failed before reply: session file locked。这个错误写代码时并不罕见，但放在卸载场景下，说明你删目录的时候，还有 agent 会话进程围着文件打转。一定要先去杀进程，再来删文件。

从技术原理上讲，OpenClaw 的 session 锁机制是它为了保证同一个 session 文件不被多个 agent 实例并发写入而设计的。每个实例启动时会 lock 其对应的会话文件，离开时释放。如果你在它还没释放的时候强行删除，或者是直接 kill 进程，锁文件虽然还在，但真正持有锁的进程已经没了，新实例再启动就会卡在等待锁超时上。所以，卸载 OpenClaw 时不要依赖杀进程解决一切问题，要先用正常流程停止，等锁释放后再删除。

5.3 遇到"Agent Failed Before Reply"这类报错应该怎么处理

这个词条在搜索热度里很高，说明很多人在部署或卸载 OpenClaw 时都撞上了同一个错误。这个报错的全貌通常长这样：

agent failed before reply: session file locked (timeout 60000ms)

意思很明显：agent 实例在真正回复之前就挂了，原因是要访问的会话文件被锁住了，等了 60000 毫秒仍然没有得到释放。这发生在配置文件目录里已有锁文件，并且有另一个进程占用会话文件的情况下。

如果说你在卸载流程中看到这个错误，那基本可以判定为：系统中仍然存在一个旧的 OpenClaw 常驻进程，它一直在尝试向会话文件写入，或者持有某个 stale lock 文件不释放。你得先定位它：

ps aux | grep -i "openclaw\|claw-agent"

或者用文件锁排查工具：

which lsof && lsof ~/.openclaw/*.lock

在 Windows 上，可以用 Sysinternals 的 handle.exe 查询进程握手的文件句柄。

找到并杀死占用进程之后，做一次安全删除锁文件的操作：

rm -f ~/.openclaw/*.lock

如果你打算保留会话做迁移，那就没必要删锁文件，但你必须先确认没有活动进程了再拷贝文件。

6. 卸载 OpenClaw 时的安全与隐私注意事项

6.1 凭据和密钥文件彻底清除

OpenClaw 是 AI 大模型应用开发环境，里面肯定保存了不少敏感信息。在我手上见过的.openclaw配置目录里，通常至少包括以下几种：

• 大模型 API 的 key 或 token，常常写在.env或config.yaml里
• 私人部署的网关 token 或签名密钥
• 智能体相关的系统提示词和外部工具的准入凭据
• 与第三方服务集成的 OAuth token，比如接入 Microsoft Teams、钉钉这类渠道时保存的刷新令牌

这些文件删除后，如果通过数据恢复工具还能找出来，理论上存在泄漏风险。所以我个人的建议是：如果你配置过大量模型密钥且之后不再使用这台机器，最好在删除前对配置目录做一次安全擦除。Linux 上可以用shred覆盖写入三次：

shred -u -z -n 3 ~/.openclaw/config.yaml shred -u -z -n 3 ~/.openclaw/.env

Windows 上可以用 cipher 命令做一个安全的目录覆盖：

cipher /w:C:\Users\你的用户名\.openclaw

顺手再把用过的 API key 在模型服务商的控制台里进行轮换，这样即使日志中残留了请求快照，也无法复用到你的账上。

6.2 日志审计与访问记录处理

OpenClaw 在调试模式下日志极其详细，包括每次请求的完整提示词、模型原始输出、工具调用链。这些日志如果有泄露，就可能暴露你正在开发的 agent 逻辑。因此，在卸载 OpenClaw 的时候，日志目录的处理不要只是删掉，还要做到不可恢复。

Linux 上的日志路径主要在：

/var/log/openclaw/ ~/.local/share/openclaw/logs/

Windows 上在：

C:\Users\用户名\AppData\Roaming\openclaw\logs

这些目录直接删除后，建议使用系统自带的"磁盘清理"或进行磁盘压缩以覆写空间。在重要机器上，甚至可以考虑将磁盘碎片整理跑一轮，让删除的文件数据块在物理位置上被覆盖。我不是数据恢复专家，但按我自己对安全的最低标准，至少要做到这个水平。

6.3 清理代理服务架构（AGENTS DEOPLOYED）

到这里，你已经把本地的卸载做得很彻底了。还有一部分值得考虑的是：OpenClaw 可能会作为一个 agent 网关服务，向外部提供连接入口。如果当时为了公网访问，配置了内网穿透或反向代理，那对应的规则也需要清理。

在 Nginx、Caddy 或云厂商的负载均衡里，凡是映射到 OpenClaw 监听端口的配置规则，都要一并移除。比如 Nginx 里指向127.0.0.1:1867的 location 或 server 块，留着虽然不会影响本地程序运行，但在未来排查网络问题时，会带来很严重的干扰。

这个扩展点，也正好体现了一个好工具卸载的复杂度：本地程序、服务、代理网关、数据残留，四层都要处理干净，才算是真卸干净了。

7. 卸载后的后续扩展建议

卸载完 OpenClaw 并不代表这件事就此结束。我根据自己的习惯，再给你提几个后续动作，让你的系统环境更干净，也让这次卸载成为一次可复用的实践。

第一，保留一份卸载操作日志。把自己执行过的命令、确认过的路径、处理过的问题记在一个 markdown 文件里。这不是形式主义，下次你换了一台新机器，或者要帮同事处理同样的问题，这份日志会大幅减少排查时间。我自己的卸载记录一般包含：安装方式、安装路径、使用的卸载命令、清理过的关键路径、处理过的异常报错、遗留注意事项。

第二，把端口释放回公共池。OpenClaw 如果占用了比较常用的端口（比如 3000 或 8080），卸载后建议验证该端口已空闲。如果端口还留有 TIME_WAIT 状态的 socket，不影响新程序绑定，但你心里要清楚网络层还有一个短暂的残留窗口。

第三，检查全局依赖的健康状态。如果你使用 npm 卸载过 OpenClaw，注意 D 可能留下一些过期的二级依赖或者触发 peer dependency 冲突。可以运行一次 npm 自检：

npm doctor

Windows 下同样适用。看到什么 ERR 信息，顺手解决掉，避免影响后续其他工具。

第四，重新评估同类工具的选型。卸载 OpenClaw 后，我很能理解你可能想换个工具。团队里也常有人对比 OpenClaw 和 WorkBuddy 这类同类 agent 工具的差异。这一块我不做拉踩式评价，只分享一个思路：选 agent 工具时，重点考察安装卸载的闭环完成度——即装上之后能不能用标准命令卸载干净。很多工具的新手体验做得非常好，但卸载文档几乎空白，这对生产环境来说就是隐形负债。

结合我自己这次在 Windows 和 Linux 两套系统上实战卸载的体会，最核心的一条经验就是：把卸载当作一次运维演练来做，而不是当作任务清单来打勾。先弄清楚对方是怎么装的，再决定怎么卸，最后用文件和进程两方面的验证来确认结果。整个过程多用系统自带的命令去排查，少用第三方清理工具，这样才能避掉百分之九十的坑。在这两套平台上把上述流程跑通之后，我再也没有出现"卸载后残留占用端口"或者"重装时配置冲突"这类问题了。