零门槛本地部署OpenClaw的卸载教程

Linux

要卸载使用 pnpm 全局安装的 openclaw，可以使用以下命令：

pnpm remove -g openclaw

或者，想省事一点的话，更简短的写法也同样有效：

pnpm rm -g openclaw

不过话说回来，包管理工具偶尔也会有点小脾气。如果上面的标准命令没起作用，别急，可以试试下面这几个排查步骤。

检查是否已卸载：

pnpm list -g | grep openclaw

如果命令行里还能看到它的名字，那说明还没清理干净。

找到pnpm全局安装目录

pnpm root -g

然后进入该目录手动删除openclaw相关文件夹

有时候“釜底抽薪”比发指令更直接，进入上一步命令显示的目录，手动删除与openclaw相关的文件夹即可。

清除缓存（可选）：

pnpm store prune

这个操作会清理未使用的包，释放磁盘空间，但不是卸载的必要步骤。

几个小提示：

-g 参数代表全局（global），这和安装时使用的 -g 是对应的。

如果当初安装时用了 --global 这种完整写法，卸载时当然也可以照搬。

验证是否成功永远是好习惯，卸载完成后，不妨通过下面两条命令确认一下：

which openclaw # 检查命令是否存在 openclaw --version # 尝试运行看是否报错

如果第一条命令没返回路径，第二条显示“command not found”，那就大功告成了。

npm 软件包卸载指南

在JavaScript的世界里，npm安装的包其实分两种：一种是待在项目文件夹里的本地包，另一种是装在系统路径下的全局包。卸载方法因“地”而异，搞清楚了分类，操作起来就清晰多了。

一、卸载项目级本地包（在 node_modules 目录）

基础卸载：这条命令会移除包文件，但不会动你的 package.json 文件。

npm uninstall # 例如：npm uninstall lodash

更新依赖记录：如果你希望卸载的同时，把 package.json 里的依赖记录也一并清除，那就需要加上对应的参数。

从 dependencies 移除（生产依赖）：

npm uninstall --save

从 devDependencies 移除（开发依赖）：

npm uninstall --save-dev

二、卸载全局包（使用 -g 安装）

这个就简单了，一个命令搞定：

npm uninstall -g # 例如：npm uninstall -g typescript

三、验证卸载结果

检查本地包是否移除：

ls node_modules | grep # 应该没有任何输出

检查全局包是否移除：

npm list -g | grep # 同样应该没有输出

四、特殊情况处理

强制清除残留：万一标准卸载流程卡住了，手动删除总是最后的“杀手锏”。

rm -rf ./node_modules/ # 删除本地包 rm -rf $(npm root -g)/ # 删除全局包

清理缓存：旧版本的缓存有时会干扰新安装，顺手清理一下是个好习惯。

npm cache clean --force # 清除npm缓存

注意事项：

卸载项目级包时有个关键点：当初安装时如果用了 --save 或 --save-dev，那么卸载时也得加上相同的参数，package.json 才会同步更新。否则，虽然文件删了，依赖列表里却还留着名字。

卸载全局包通常需要管理员权限，在Linux或macOS系统下，记得在前面加上 sudo。

如果手动删除文件后，npm list 之类的命令还显示包信息，可以尝试执行 npm rebuild 来重新生成依赖树。

手动卸载步骤

有些工具没有提供一键卸载命令，这就需要我们手动清理了。整个过程其实不难，按顺序来就行。

备份配置文件（推荐预防措施）

首先，安全第一。配置文件默认放在 ~/.openclaw/ 目录下，里面可能有你的个性化设置。卸载前备份一下，有备无患。

cp -r ~/.openclaw ~/.openclaw_backup # 备份整个配置目录

这样，万一以后需要恢复数据，还能从备份里找回来。

删除配置目录

接下来，就是彻底移除配置目录。执行下面这条命令：

rm -rf ~/.openclaw # 这会永久移除配置文件和设置

这一步很关键，相当于清除了应用在用户层面的所有“记忆”。

删除系统安装的可执行文件

然后，我们需要找到并删除那些被安装到系统路径里的可执行文件。

先来定位它们到底装在哪了：

which openclaw # 查找主程序，返回值如“/usr/local/bin/openclaw” which clawdbot # 查找可能的相关工具

找到路径后，使用 sudo 权限删除这些文件。例如：

sudo rm /usr/local/bin/openclaw # 删除主可执行文件 sudo rm /usr/local/bin/clawdbot # 删除相关工具文件

当然，如果系统提示找不到文件，说明没安装在这些标准位置，跳过即可。

验证卸载是否彻底

所有步骤完成后，最好重启一下终端，然后做最终验证：

openclaw --version # 应显示“command not found”错误 ls -la ~ | grep .openclaw # 应无输出

如果两条命令都符合预期，那么恭喜你，手动卸载工作已经圆满完成了。

注意事项

需要了解的是，OpenClaw目前可能没有提供官方的卸载脚本，因此手动删除是标准操作后的必要补充。

手动操作虽然直接，但有一个潜在风险：它可能无法百分百移除所有通过其他方式安装的依赖或分散的系统文件。如果你最初是通过类似 apt 或 yum 这样的系统包管理器安装的，那可能还需要运行对应的移除命令。

最后给个建议，如果未来需要重新安装，强烈推荐走官方渠道，这样可以最大限度地避免残留配置可能带来的冲突问题。如果在操作中遇到任何复杂情况，查阅官方文档或寻求社区支持总是最稳妥的途径。