OpenClaw 完全卸载指南：两种方法帮你彻底清理

如果你决定不再使用 OpenClaw，或者想重新安装一个干净的版本，那么正确卸载就很重要了。我整理了这份指南，帮你根据不同情况选择合适的卸载方式。

开始之前：判断你的情况

在动手之前，先确认一下你属于哪种情况：

• 情况一：OpenClaw 的命令行工具（CLI）还能正常使用 → 用简单方式卸载
• 情况二：CLI 已经被删除了，但后台服务还在运行 → 用手动服务移除

怎么判断？很简单，打开终端输入 openclaw --version，如果能看到版本号，就是情况一；如果提示命令不存在，但你发现系统里还有 OpenClaw 的进程在跑，那就是情况二。

方法一：简单方式（推荐）

如果你的 OpenClaw CLI 还在，这是最省心的方法。

一键卸载

OpenClaw 自带了卸载程序，只需要一行命令：

openclaw uninstall

运行后，程序会引导你完成整个卸载过程。如果你想在脚本中自动化执行，不需要任何交互，可以用这个：

openclaw uninstall --all --yes --non-interactive

或者如果你是通过 npx 临时运行的：

npx -y openclaw uninstall --all --yes --non-interactive

手动分步卸载

如果你想更清楚地了解每一步在做什么，或者自动卸载遇到问题，可以按照下面的步骤手动操作。

第一步：停止网关服务

首先要把正在运行的 Gateway 网关服务停下来：

openclaw gateway stop

这一步很重要，因为如果服务还在运行，后面删除文件时可能会遇到"文件被占用"的问题。

第二步：卸载网关服务

接下来把网关服务从系统的自动启动列表中移除：

openclaw gateway uninstall

这个命令会根据你的操作系统，自动处理 macOS 的 launchd、Linux 的 systemd 或 Windows 的计划任务。

第三步：删除配置和状态文件

OpenClaw 会在你的用户目录下保存一些配置和运行状态，现在可以删掉了：

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

这里有个小细节：如果你之前自定义了配置文件的位置（通过 OPENCLAW_CONFIG_PATH 环境变量），记得也要把那个文件删掉。

第四步：清理工作区（可选）

如果你在 OpenClaw 中创建过智能体或其他工作文件，它们默认保存在工作区目录。如果确定不需要了，可以删除：

rm -rf ~/.openclaw/workspace

注意：这一步是可选的，如果你还想保留这些文件以后用，就跳过这步。

第五步：移除 CLI 工具

根据你当初是用什么包管理器安装的，选择对应的命令：

# 如果用的是 npm
npm rm -g openclaw

# 如果用的是 pnpm
pnpm remove -g openclaw

# 如果用的是 bun
bun remove -g openclaw

第六步：删除 macOS 应用（如果有）

如果你在 macOS 上安装了 OpenClaw 的图形界面应用，也要删掉：

rm -rf /Applications/OpenClaw.app

特殊情况提醒

使用了配置文件（Profile）

如果你用了 --profile 参数或设置了 OPENCLAW_PROFILE 环境变量，那么每个配置文件都有自己的状态目录（通常是 ~/.openclaw-<profile>）。你需要对每个配置文件重复第三步的删除操作。

远程模式

如果你是在远程模式下使用 OpenClaw，状态目录实际上在远程的 Gateway 主机上。所以第一到第四步需要在那台远程机器上执行。

方法二：手动服务移除

这种情况比较少见，但如果你不小心删除了 CLI 工具，而后台服务还在运行，就需要手动清理了。

macOS 系统

OpenClaw 在 macOS 上使用 launchd 管理服务，默认的服务标签是 bot.molt.gateway：

launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

如果你用了配置文件，标签名会变成 bot.molt.<profile>，相应地修改上面的命令。另外，旧版本可能使用 com.openclaw.* 作为标签，如果发现有这样的 plist 文件，也一并删除。

Linux 系统

Linux 上使用 systemd 用户单元，默认单元名是 openclaw-gateway.service：

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

最后一行的 daemon-reload 是让 systemd 重新加载配置，确保删除生效。

Windows 系统

Windows 上使用计划任务，默认任务名是 OpenClaw Gateway：

schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

如果用了配置文件，任务名会变成 OpenClaw Gateway (<profile>)，记得相应修改。

不同安装方式的卸载差异

通过安装脚本或包管理器安装

如果你是用官方的安装脚本（https://openclaw.ai/install.sh 或 install.ps1）安装的，或者直接用 npm/pnpm/bun 安装的，那么 CLI 工具是全局安装的。

卸载时用对应的包管理器命令就行：

npm rm -g openclaw
# 或
pnpm remove -g openclaw
# 或
bun remove -g openclaw

从源码安装

如果你是从 GitHub 克隆的源码仓库，然后直接运行的（git clone + openclaw ... 或 bun run openclaw ...），卸载步骤稍有不同：

1. 先卸载服务：在删除仓库目录之前，一定要先用上面的方法卸载 Gateway 服务
2. 删除仓库：然后才能删除克隆的仓库目录
3. 清理状态文件：最后按照前面的步骤删除状态目录和工作区

为什么要先卸载服务？因为服务配置里可能引用了仓库目录中的文件，如果先删除仓库，服务可能会出现异常。

验证卸载是否成功

完成上面的步骤后，你可以检查一下是否卸载干净了：

1. 运行 openclaw --version，应该提示命令不存在
2. 检查 ~/.openclaw 目录是否已删除
3. 在 macOS 上运行 launchctl list | grep openclaw，应该没有输出
4. 在 Linux 上运行 systemctl --user list-units | grep openclaw，应该没有输出
5. 在 Windows 上运行 schtasks /Query | findstr OpenClaw，应该没有输出

如果以上检查都通过了，说明 OpenClaw 已经完全卸载了。

常见问题

Q：卸载后还能恢复数据吗？

A：如果你已经删除了 ~/.openclaw 目录和工作区，数据就无法恢复了。所以在执行删除操作前，建议先备份重要的配置和工作文件。

Q：卸载时提示"权限不足"怎么办？

A：某些操作可能需要管理员权限。在 macOS/Linux 上，可以在命令前加 sudo；在 Windows 上，需要以管理员身份运行 PowerShell。

Q：我想重新安装，需要完全卸载吗？

A：不一定。如果只是想升级版本，直接重新安装就行，会自动覆盖旧版本。只有在遇到问题需要"干净安装"时，才需要完全卸载。

希望这份指南能帮到你。如果在卸载过程中遇到任何问题，可以查看 OpenClaw 的官方文档或社区寻求帮助。