OpenClaw 完全卸载清理指南

很多朋友在使用 OpenClaw 的过程中，可能会遇到需要卸载重新安装、或者想要彻底清理干净的情况。今天我就给大家整理一份超详细的完全卸载清理指南，不管你是 Mac、Windows 还是 Linux 用户，照着做就能彻底卸载干净，一点残留都不留下。

先搞清楚：你想怎么卸载？

在开始卸载之前，我们先明确两种场景：

仅卸载程序，保留配置数据：如果你只是想重新安装程序，但是希望保留你的配置、授权信息、工作区数据等，可以选择这种方式，下次安装完成后直接就能用，不用重新配置。

完全卸载，包括所有配置和数据：如果你真的不需要了，或者想要彻底清理干净从头开始，那就选择这种方式，会删除所有相关文件。

卸载前的准备工作

在开始卸载之前，建议先做好这两件事：

关闭 OpenClaw 所有相关进程：如果 OpenClaw 正在运行，先停止它的服务，不然可能会出现文件被占用无法删除的情况。

备份重要数据：如果你有重要的工作区数据或者自定义配置，建议先备份出来，避免误删。

不同安装方式的卸载方法

OpenClaw 常见的安装方式有两种：通过npm全局安装和官方脚本安装。我们分别来说明。

方式一：通过 npm 安装的卸载步骤

如果你是通过 npm install -g openclaw-cn 命令安装的，首先需要卸载 npm 全局包：

卸载全局安装的 openclaw-cn

npm uninstall -g openclaw-cn

如果你使用的是 yarn 安装：

yarn 方式卸载

yarn global remove openclaw-cn

如果你使用的是 pnpm 安装：

pnpm 方式卸载

pnpm remove -g openclaw-cn

执行完上述命令后，npm 包就卸载完成了，接下来我们继续清理数据目录和配置文件。

方式二：官方脚本安装的卸载步骤

如果你是通过官方一键脚本安装的，需要先找到可执行文件位置，然后删除它。

通常手动安装会把 openclaw-cn 可执行文件放在 /usr/local/bin/ 或者 /usr/bin/ 目录下，可以通过以下命令查找：

查找 openclaw-cn 可执行文件位置

which openclaw-cn

找到路径后，直接删除即可：

例如如果路径是 /usr/local/bin/openclaw-cn

sudo rm -f /usr/local/bin/openclaw-cn

分系统清理数据目录和配置文件

卸载完程序后，最重要的一步就是清理数据目录、配置文件和缓存，这才是保证完全卸载干净的关键。

🖥️ Mac 系统清理步骤

OpenClaw 在 Mac 系统下的数据目录通常在以下位置：

1. 用户数据和配置目录（包含配置、工作区、日志等）

删除用户数据目录（完全卸载时执行）

rm -rf ~/.openclaw

2. 缓存目录（可选）

删除缓存文件

rm -rf ~/Library/Caches/OpenClaw

3. 如果是通过 Homebrew 安装的

如果你是通过 Homebrew 安装的，还需要执行：

卸载 openclaw

brew uninstall openclaw-cn

🪟 Windows 系统清理步骤

Windows 系统下，OpenClaw 的数据目录通常在：

1. 用户数据和配置目录

打开资源管理器，在地址栏输入：

%USERPROFILE%\.openclaw

直接删除这个文件夹即可。

2.程序文件卸载

如果你是安装到了 Program Files 目录下：

打开「控制面板」→「程序和功能」

找到 OpenClaw，点击「卸载」

按照提示完成卸载

如果你是解压使用的，直接删除解压的文件夹即可。

3. 清理环境变量

如果你手动把 OpenClaw 添加到了系统 PATH 环境变量中，记得去环境变量设置里删除对应的路径。

🐧 Linux 系统清理步骤

Linux 系统下的清理步骤和 Mac 基本一致：

1. 删除用户数据目录

删除用户数据和配置（完全卸载时执行）

rm -rf ~/.openclaw

2. 如果是配置成了系统服务

如果你把 OpenClaw 配置成了 systemd 系统服务，还需要停止并禁用服务：

systemd 系统

sudo systemctl stop openclaw-gateway

sudo systemctl disable openclaw-gateway

sudo rm -f /etc/systemd/system/openclaw-gateway.service

sudo systemctl daemon-reload

分情况选择：保留配置 vs 完全卸载

根据你的需求，执行不同的清理步骤：

✅ 如果你想保留配置，只卸载程序

只需要执行前面的卸载程序步骤，不要删除 ~/.openclaw 目录即可。这样下次重新安装后，你的配置、授权信息、工作区数据都会保留，直接就能使用。

✅ 如果你想完全卸载，包括所有配置

在卸载完程序后，继续执行前面的清理数据目录步骤，删除 ~/.openclaw（Linux/Mac）或者 %USERPROFILE%\.openclaw（Windows），这样就彻底干净了。

如何检查是否卸载干净？

卸载完成后，我们可以通过以下方法验证是否卸载干净：

1. 检查命令是否还能识别

检查 openclaw-cn 命令是否还存在

which openclaw-cn

如果什么都没有输出，说明可执行文件已经删除干净了。

Windows 用户可以在 CMD 中执行：

where openclaw-cn

如果提示「找不到文件」，说明可执行文件已经删除干净。

2. 检查数据目录是否存在

检查数据目录是否还存在

ls -la ~/.openclaw

如果提示「No such file or directory」，说明数据目录已经删除干净。

Windows 用户检查 %USERPROFILE%\.openclaw 文件夹是否还存在，如果不存在就是干净的。

3. 检查 npm 包是否还存在

如果你是通过 npm 安装的：

检查 npm 全局包中是否还有 openclaw-cn

npm list -g openclaw-cn

如果显示 empty 或者 not found，说明 npm 包已经卸载干净了。

常见问题解答

❓ 问题一：找不到 openclaw 安装路径怎么办？

解决方法：

在 Linux/Mac 上执行：

查找所有可能的 openclaw-cn 可执行文件

whereis openclaw-cn

或者：

全盘搜索 openclaw-cn

find / -name "openclaw-cn" 2>/dev/null

在 Windows 上，可以用 Everything 工具搜索「openclaw」，就能找到所有相关文件位置。

❓ 问题二：卸载后还有残留文件删不掉怎么办？

原因：还有 OpenClaw 进程在运行，文件被占用。

解决方法：

先杀掉所有 openclaw 相关进程：Linux/Mac:Windows:

然后再尝试删除文件，一般就能删掉了。

如果还是删不掉，可以重启电脑后再删除。

❓ 问题三：卸载后重新安装需要注意什么？

如果你完全卸载后想要重新安装：

如果之前保留了配置：直接安装即可，安装程序会自动读取之前的配置，不需要重新授权。

如果之前完全卸载了：安装完成后需要重新进行用户授权，工作区需要重新配置。

建议：如果是因为出问题重新安装，建议完全卸载后再安装，避免旧配置引发新的问题。

❓ 问题四：为什么卸载了还占用磁盘空间？

很可能是你没有清理数据目录，~/.openclaw 目录下会存放日志、缓存、工作区数据等，时间长了可能会占用不少空间。按照前面的步骤删除这个目录就能释放空间了。

你可以用以下命令查看占用了多少空间：

查看 .openclaw 目录占用空间

du -sh ~/.openclaw

❓ 问题五：只想要清理缓存，不卸载程序可以吗？

当然可以！如果你只是想清理缓存释放空间，不需要卸载程序，只需要删除缓存目录即可：

清理缓存目录

rm -rf ~/.openclaw/cache/*

这样不会影响你的配置和数据，只是清理了临时缓存文件。

总结：完整卸载步骤一键梳理

我给大家整理了一个完整的检查清单，照着做一遍就能彻底卸载干净：

停止 OpenClaw 服务：openclaw-cn gateway stop

卸载程序：

根据需求选择：

验证：执行 which openclaw-cn 确认命令不存在

检查：确认数据目录已删除

按照这个指南操作，不管是什么系统什么安装方式，都能彻底把 OpenClaw 卸载干净。如果你还有其他问题，欢迎在评论区留言讨论。

觉得这篇文章有用的话，别忘了点赞、在看、分享给需要的朋友～

如果你想了解更多 OpenClaw 的使用技巧，欢迎关注，后续会分享更多实战教程。