如何彻底卸载“龙虾”?一份不留任何痕迹的 OpenClaw 终极删除清理指南

OpenClaw有时由于这样或那样的原因需要卸载干净或以后再重新安装，还在为 OpenClaw 卸载不干净而烦恼？服务残留、配置散落、下次重装报错？别急，这份保姆级教程，现在用不到可先收藏或转发，那么带你从入门到精通，让 OpenClaw 从你的系统里彻底消失！

为什么你的 OpenClaw 总是删除清理不干净？

很多朋友反馈，卸载 OpenClaw（江湖人称“龙虾”）后，总觉得没删干净。端口还被占用？重装时提示冲突？这通常是因为它的 “网关服务” 在后台默默运行，或者 配置文件、状态目录 没有被彻底清理。

今天，我就来手把手教你，如何根据你的实际情况，选择正确的卸载路径，实现 100% 彻底清除。

首先，快速自检：你属于哪种情况？

1. ✅ 情况 A：openclaw命令还能用

• 在终端输入 

  openclaw --version

还能看到版本信息。

• 恭喜你！ 你可以走最省心的 “简易卸载路径”。

1. 情况 B：openclaw命令已失效，但感觉电脑变卡或端口被占

• 命令找不到，但通过活动监视器（Mac）、任务管理器（Windows）或 

  systemctl/ps

  （Linux）发现疑似 OpenClaw 的进程还在跑。

• 你需要走“手动清理路径”，直接对系统服务“动手术”。请对号入座，然后我们分路进发。

方法路径一：简易卸载（命令还在，推荐首选）

这是最优雅、最推荐的方式。核心是利用 OpenClaw 自带的卸载工具。

终极一键命令（推荐所有人使用）

打开你的终端（Terminal、CMD、PowerShell 等），输入以下命令，它会自动完成所有步骤，无需确认：

bash

bash复制openclaw uninstall --all --yes --non-interactive

如果你当初是通过 npx临时安装的，也可以用这个“懒人包”：

bash

bash复制npx -y openclaw uninstall --all --yes --non-interactive

分步详解（供好奇宝宝参考）

如果你想知道上面那条命令到底干了啥，可以参考下面的手动步骤，效果完全一样：

1. 停止服务：

   openclaw gateway stop

2. 卸载服务：

   openclaw gateway uninstall

   （这会从系统服务列表里移除它）

3. 删除核心数据：

   bash

• bash复制rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

  ⚠️ 重要提示：如果你曾经设置过 OPENCLAW_CONFIG_PATH环境变量指向了别处，请务必手动找到并删除那个单独的配置文件。

4. 清理工作区（建议）：

   bash

• bash复制rm -rf ~/.openclaw/workspace

  这里存放着 Agent 运行时的临时文件，清理掉更清爽。

5. 卸载 CLI 本体（根据你的包管理器选择一条）：

   bash

6. bash复制# 用 npm 装的npm rm -g openclaw# 用 pnpm 装的pnpm remove -g openclaw# 用 bun 装的bun remove -g openclaw

   Mac 用户专属：如果你还安装了桌面应用，请手动删除：

   bash

bash复制rm -rf /Applications/OpenClaw.app

完成以上步骤，恭喜你，简易卸载成功！

路径二：手动清理（命令已挂，服务残留）

当 openclaw命令失效时，我们就需要直接操作系统的服务管理工具。请根据你的操作系统选择。

🍎 macOS 系统用户

OpenClaw 在 macOS 上通常注册为 LaunchAgent。

1. 打开“终端”，执行以下两条命令：

   bash

2. bash复制launchctl bootout gui/$UID/ai.openclaw.gatewayrm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

   如果你创建过多个配置（用了 --profile）：请将上面命令中的 

   ai.openclaw.gateway

   替换为 

   ai.openclaw.<你的profile名>

3. 检查历史遗留：老版本可能使用 com.openclaw.*的命名，可以去 ~/Library/LaunchAgents/目录下看看，有就一并删除。

🐧 Linux 系统用户

OpenClaw 在 Linux 上通常注册为 systemd 用户服务。

1. 打开终端，执行：

   bash

2. bash复制systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

   如果你用了 --profile：请将 

   openclaw-gateway.service

   替换为 

   openclaw-gateway-<你的profile名>.service

🪟 Windows 系统用户

OpenClaw 在 Windows 上通常注册为 计划任务。

1. 以管理员身份打开 PowerShell 或 CMD。

2. 删除计划任务：

   bash

3. bash复制schtasks /Delete /F /TN "OpenClaw Gateway"

   删除任务脚本：

   powershell

4. powershell复制Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

   如果你用了 --profile：任务名会是 

   OpenClaw Gateway (<profile名>)

   脚本路径则为 

   $env:USERPROFILE\.openclaw-<profile名>\gateway.cmd

   请相应替换并删除。

手动清理后别忘了：执行上面【路径一】中的 第3步（删除状态目录）和第4步（删除工作区），以清除磁盘上的残留文件。

🚨 三大“隐藏雷区”，90%的人会踩坑！

即使完成了上述操作，下面这些特殊情况没处理好，依然可能导致清理不彻底。

1. 多 Profile 用户：

• 坑点：每个 --profile都会生成独立的状态目录，如 ~/.openclaw-work。

• 排雷：你需要手动逐一检查并删除所有类似 ~/.openclaw-*的目录。

2. 远程模式用户：

• 坑点：在远程模式下，状态目录和网关服务都在远程主机上！

• 排雷：请登录到那台作为网关的远程服务器，在那台机器上执行停止服务和删除目录的操作。在本机操作是无效的。

3. 源码运行大神：

• 坑点：如果你是 git clone源码后直接 bun run运行的，卸载顺序错了会导致进程僵死。

• 排雷：务必按顺序操作：

1. 先 卸载网关服务（用上面的任一路径）。

2. 然后 再删除你的源码仓库文件夹。

3. 最后 清理状态目录和 workspace。

收尾与验证

完成所有步骤后，你可以通过以下方式验证是否清理干净：

• 检查进程：在活动监视器、任务管理器或使用 

  ps aux | grep openclaw

  查看是否还有相关进程。

• 检查端口：OpenClaw 默认使用一些端口（如 3000），可以检查这些端口是否还被占用。

• 检查目录：确认 

  ~/.openclaw

  以及所有 

  ~/.openclaw-*

  目录都已消失。

至此，你已经和 OpenClaw 彻底告别，可以安心尝试其他工具，或者等待一个全新的开始了！

本文基于 OpenClaw 官方卸载文档整理，力求准确。如果在操作中遇到文档未覆盖的疑难杂症，建议查阅官方文档或在私信或留言讨论。

关注公众号  若获取更多相关资源服务请访问SoloAILabs官网