夜雨聆风OpenClaw有时由于这样或那样的原因需要卸载干净或以后再重新安装，还在为 OpenClaw 卸载不干净而烦恼？服务残留、配置散落、下次重装报错？别急，这份保姆级教程，现在用不到可先收藏或转发，那么带你从入门到精通，让 OpenClaw 从你的系统里彻底消失！
为什么你的 OpenClaw 总是删除清理不干净？
很多朋友反馈，卸载 OpenClaw（江湖人称“龙虾”）后，总觉得没删干净。端口还被占用？重装时提示冲突？这通常是因为它的 “网关服务” 在后台默默运行，或者 配置文件、状态目录 没有被彻底清理。
今天，我就来手把手教你，如何根据你的实际情况，选择正确的卸载路径，实现 100% 彻底清除。
首先，快速自检：你属于哪种情况？
✅ 情况 A：
openclaw命令还能用在终端输入
openclaw --version
还能看到版本信息。
恭喜你！ 你可以走最省心的 “简易卸载路径”。
情况 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
分步详解（供好奇宝宝参考）
如果你想知道上面那条命令到底干了啥，可以参考下面的手动步骤，效果完全一样：
停止服务：
openclaw gateway stop卸载服务：
openclaw gateway uninstall（这会从系统服务列表里移除它）删除核心数据：
bash
bash复制rm-rf"${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"⚠️ 重要提示：如果你曾经设置过
OPENCLAW_CONFIG_PATH环境变量指向了别处，请务必手动找到并删除那个单独的配置文件。清理工作区（建议）：
bash
bash复制rm-rf ~/.openclaw/workspace这里存放着 Agent 运行时的临时文件，清理掉更清爽。
卸载 CLI 本体（根据你的包管理器选择一条）：
bash
bash复制# 用 npm 装的npmrm-g openclaw# 用 pnpm 装的pnpm remove -g openclaw# 用 bun 装的bun remove -g openclawMac 用户专属：如果你还安装了桌面应用，请手动删除：
bash
bash复制rm-rf /Applications/OpenClaw.app
完成以上步骤，恭喜你，简易卸载成功！
路径二：手动清理（命令已挂，服务残留）
当 openclaw命令失效时，我们就需要直接操作系统的服务管理工具。请根据你的操作系统选择。
🍎 macOS 系统用户
OpenClaw 在 macOS 上通常注册为 LaunchAgent。
打开“终端”，执行以下两条命令：
bash
bash复制launchctl bootout gui/$UID/ai.openclaw.gatewayrm-f ~/Library/LaunchAgents/ai.openclaw.gateway.plist如果你创建过多个配置（用了
--profile）：请将上面命令中的ai.openclaw.gateway替换为ai.openclaw.<你的profile名>检查历史遗留：老版本可能使用
com.openclaw.*的命名，可以去~/Library/LaunchAgents/目录下看看，有就一并删除。
🐧 Linux 系统用户
OpenClaw 在 Linux 上通常注册为 systemd 用户服务。
打开终端，执行：
bash
bash复制systemctl --userdisable--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 上通常注册为 计划任务。
以管理员身份打开 PowerShell 或 CMD。
删除计划任务：
bash
bash复制schtasks /Delete /F /TN"OpenClaw Gateway"删除任务脚本：
powershell
powershell复制Remove-Item -Force"$env:USERPROFILE\.openclaw\gateway.cmd"如果你用了
--profile：任务名会是OpenClaw Gateway (<profile名>)脚本路径则为$env:USERPROFILE\.openclaw-<profile名>\gateway.cmd请相应替换并删除。
手动清理后别忘了：执行上面【路径一】中的 第3步（删除状态目录）和第4步（删除工作区），以清除磁盘上的残留文件。
🚨 三大“隐藏雷区”，90%的人会踩坑！
即使完成了上述操作，下面这些特殊情况没处理好，依然可能导致清理不彻底。
多 Profile 用户：
坑点：每个
--profile都会生成独立的状态目录，如~/.openclaw-work。排雷：你需要手动逐一检查并删除所有类似
~/.openclaw-*的目录。远程模式用户：
坑点：在远程模式下，状态目录和网关服务都在远程主机上！
排雷：请登录到那台作为网关的远程服务器，在那台机器上执行停止服务和删除目录的操作。在本机操作是无效的。
源码运行大神：
坑点：如果你是
git clone源码后直接bun run运行的，卸载顺序错了会导致进程僵死。排雷：务必按顺序操作：
先 卸载网关服务（用上面的任一路径）。
然后 再删除你的源码仓库文件夹。
最后 清理状态目录和 workspace。
收尾与验证
完成所有步骤后，你可以通过以下方式验证是否清理干净：
检查进程：在活动监视器、任务管理器或使用
ps aux | grep openclaw查看是否还有相关进程。检查端口：OpenClaw 默认使用一些端口（如 3000），可以检查这些端口是否还被占用。
检查目录：确认
~/.openclaw以及所有~/.openclaw-*目录都已消失。
至此，你已经和 OpenClaw 彻底告别，可以安心尝试其他工具，或者等待一个全新的开始了！
本文基于 OpenClaw 官方卸载文档整理，力求准确。如果在操作中遇到文档未覆盖的疑难杂症，建议查阅官方文档或在私信或留言讨论。
关注公众号 若获取更多相关资源服务请访问SoloAILabs官网
