1. 卸载 OpenClaw 后为什么还会“阴魂不散”
很多人以为敲完npm uninstall -g openclaw就万事大吉,结果重装时发现旧配置还在、命令还能跑、甚至报错信息跟卸载前一模一样。这不是错觉,而是 npm 全局包、缓存目录、用户配置目录这三处残留各管各的,卸载命令只动了第一处。
OpenClaw(小龙虾)这类 AI 助手工具,本质是一个 Node.js 全局 CLI,它会在三个地方留下痕迹:一是 npm 的全局安装目录,二是 npm 的缓存目录(存着 tarball 和元数据),三是用户主目录下的.openclaw配置与日志目录。前两个由 npm 管理,第三个是程序自己写的。你只卸载包,配置目录纹丝不动;你只删配置,缓存里的旧版本 tarball 还在,重装时 npm 可能直接拿缓存装回旧版。
这篇就按“排查—清理—验证”的顺序,把 Windows、macOS、Linux 三端的残留位置和可复制命令讲清楚,最后顺带说一句怎么用 TaoToken 把 Key 和 API 通道统一收尾,避免卸载一个工具后其他 AI 工具的配置互相打架。适合已经决定不用 OpenClaw、或者准备重装干净版本的人跟着做。
2. 清理前先用 TaoToken 把 API 通道收个尾
卸载工具本身不难,难的是“配置不打架”。OpenClaw 这类工具通常会在自己的配置文件里写死一个 API Base URL 和 Key。如果你同时还在用其他 AI 编码工具,卸载后旧配置残留可能导致新工具读错通道,或者你手动改 Key 时找不到源头。
我的做法是:在清理 OpenClaw 之前,先把 API 通道统一到一个地方管理。TaoToken 提供统一的 Key 和 API 通道,官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,API 地址是 https://taotoken.net/api 。这样你后续无论重装 OpenClaw 还是换别的工具,Key 和 Base URL 都从同一处取,不会出现“这个工具用 A 通道、那个工具用 B 通道”的混乱。
具体操作上,你可以先登录控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 确认现有 Key,再到 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 生成或复制一个专用 Key。如果你打算卸载后继续用编码类工具,可以了解 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ;想先验证模型通不通,用模型对话 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 试一条请求即可。
注意:这一步不是必须的,但如果你机器上同时装了多个 AI CLI 工具,先统一通道能省掉后面“到底哪个配置文件在生效”的排查时间。
3. 三端可复制的残留清理命令
下面按系统分。核心思路一致:先卸全局包,再清 npm 缓存,最后删用户配置目录,每一步都给验证命令。
3.1 Windows:管理员 PowerShell 逐条执行
先确认当前全局包列表里有没有 openclaw:
npm list -g --depth=0看到openclaw后执行卸载:
npm uninstall -g openclaw清 npm 缓存。先查缓存目录在哪:
npm config get cache假设输出是C:\Users\你的用户名\AppData\Local\npm-cache,直接强制清理:
npm cache clean --force如果提示权限或文件被占用导致失败,手动删缓存目录(把路径换成你上一步查到的):
Remove-Item -Recurse -Force "C:\Users\你的用户名\AppData\Local\npm-cache"删用户配置目录。OpenClaw 默认在用户主目录下写.openclaw:
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"如果删不掉,多半是进程还占着文件,重启后再执行,或者手动到C:\Users\你的用户名\下找到.openclaw文件夹删除。
3.2 macOS 与 Linux:sudo 加 rm -rf
macOS 和 Linux 步骤几乎一样。先卸载全局包:
sudo npm uninstall -g openclaw清缓存:
npm cache clean --force删配置和日志目录:
rm -rf ~/.openclawmacOS 如果之前用 Homebrew 装过相关依赖,可以顺手检查:
brew list | grep -i openclaw有输出就brew uninstall对应包名。Linux 上如果用 pnpm 装的,把npm换成pnpm再跑一遍卸载命令。
3.3 残留位置速查表
| 残留类型 | Windows 路径 | macOS / Linux 路径 | 清理方式 |
|---|---|---|---|
| 全局包 | npm 全局 node_modules | 同左 | npm uninstall -g |
| npm 缓存 | npm config get cache 输出 | 同左 | npm cache clean --force |
| 用户配置 | %USERPROFILE%\.openclaw | ~/.openclaw | 手动删除目录 |
| 日志文件 | 配置目录内 logs | ~/.openclaw/logs | 随配置目录一起删 |
4. 验证请求:确认真的卸干净了
清理完别急着关终端,跑三条验证。
第一条,查命令是否还存在:
openclaw --version正常应该提示command not found或不是内部或外部命令。如果还能输出版本号,说明全局包没卸干净,回到第 3 步检查是不是用了 pnpm 或 yarn 装的。
第二条,查全局包列表:
npm list -g --depth=0输出里不应再出现 openclaw。
第三条,查配置目录是否还在:
ls ~/.openclawmacOS / Linux 下应提示No such file or directory;Windows 下:
Test-Path "$env:USERPROFILE\.openclaw"返回False才算干净。
如果你卸载后准备重装,重装前建议先用 TaoToken 的模型对话页面发一条测试请求,确认 Key 和通道本身是通的,避免把“通道问题”误判成“OpenClaw 装坏了”。模型对话入口:https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
5. 本篇常见错排查
报错一:npm uninstall -g openclaw提示 EPERM 或权限不足。Windows 上没用管理员 PowerShell,或者杀毒软件锁了文件。换管理员终端重试,仍失败就重启后先删缓存目录再卸。
报错二:缓存清理后重装还是旧版本。说明缓存没清干净,或者你用的不是 npm 而是 pnpm/yarn。分别执行pnpm store prune或yarn cache clean,再确认npm config get cache的目录确实被删了。
报错三:删.openclaw提示目录被占用。有后台进程还在跑。Windows 用任务管理器结束 node 相关进程,macOS/Linux 用ps aux | grep openclaw找到 PID 后 kill,再删。
报错四:卸载后其他 AI 工具报 401 或通道错误。大概率是旧配置里的 Base URL 或 Key 残留被新工具读到了。检查各工具的配置文件,把 API 地址统一改成 https://taotoken.net/api ,Key 从 API Keys 页面重新复制一份,别混用旧 Key。
报错五:openclaw --version还能跑但 npm 列表里没有。可能是手动装过二进制,或者 PATH 里残留了软链接。macOS/Linux 用which openclaw定位文件后手动删;Windows 用where openclaw查路径。
6. 收尾:把 Key 和通道固定下来
卸载和清理只是第一步,真正省心的是让后续所有 AI 工具都从同一个通道取 Key。我现在的习惯是:任何工具卸载前,先确认它的 API 配置指向哪里;卸载后,把统一通道的 Key 和 Base URL 记在一个地方,重装或换工具时直接填。
如果你还在用编码类工具或 Agent,可以走 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,把长期用的 Key 固定下来;接入细节看文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,Key 管理在 API Keys https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。这样下次再卸载什么工具,你只需要删本地目录,通道侧不用动,配置也不会打架。