彻底卸载 OpenClaw (龙虾) 指南

彻底卸载 OpenClaw (龙虾) 指南

想把 OpenClaw（大家常叫它“龙虾”）从你的系统里清理干净？这事儿得讲究个章法，胡乱删除往往治标不治本，残留的服务和文件就像散落在角落的贝壳，时不时硌你一下。接下来，咱们就按一套稳妥的流程，帮你把它请走。

卸载原则

核心原则就一句话：先停服务，再卸工具，最后清文件。这个顺序千万别颠倒，否则很容易留下“后遗症”。

快速卸载方法

如果你追求效率，想用最少命令搞定，直接在终端（或 Windows 下的 PowerShell）里依次执行这三步就行：

1. openclaw gateway uninstall（核心，先卸载服务）
2. npm rm -g openclaw（接着，删除全局安装的 CLI 工具）
3. 手动删除 ~/.openclaw 这个用户目录下的配置文件包。

完整卸载步骤（全平台）

为了确保万无一失，特别是对付那些跨平台的复杂情况，下面这份详尽的步骤清单会更可靠。

1. 停止并卸载后台服务（关键步骤）

这是整个卸载过程中最至关重要的一环。打开你的命令行工具，运行：

openclaw gateway stop
openclaw gateway uninstall

这两个命令的作用是通知系统，把 OpenClaw 在后台默默运行的服务彻底关停并移除。它会自动处理不同系统下的任务管理机制：

• macOS：清理 launchd 中的后台驻留项。
• Linux：移除 systemd 管理的服务单元。
• Windows：删除 Scheduled Tasks（计划任务）中的相关任务。

2. 卸载CLI工具

服务清理干净后，就该卸载你当初通过包管理器安装的命令行工具了。根据你当时的安装方式，对号入座执行以下命令之一：

# 最普遍的 npm 安装方式
npm rm -g openclaw

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

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

3. 删除配置文件

工具卸了，但它生成的个人配置和数据还留在你的电脑里。需要手动清理用户目录下的专属文件夹：

• macOS/Linux：在终端执行 rm -rf ~/.openclaw
• Windows：去文件资源管理器，删除 C:\Users\<你的用户名>\.openclaw 这个目录。

4. 清理其他残留

视情况，可能还需要检查以下位置：

• macOS：如果你曾将它拖入“应用程序”文件夹，可以运行 rm -rf /Applications/OpenClaw.app 来删除。
• Windows：检查桌面或开始菜单，手动删除可能存在的快捷方式。

注意事项

⚠️ 警惕这两个常见错误

• 顺序搞反了：如果先执行了 npm rm -g openclaw，那么 openclaw gateway uninstall 这个关键命令就无法执行了，因为命令本身已被删除，导致服务残留。
• 忘了停止服务：直接去删除 .openclaw 文件夹，而不先停止服务，可能会导致后台进程“无家可归”却仍在运行，继续占用端口和系统资源。

验证卸载

全部操作完成后，如何确认已经成功？很简单，在终端或命令提示符里试着输入：

openclaw

如果系统反馈“command not found”（找不到命令）或“‘openclaw’不是内部或外部命令”，那就恭喜你，OpenClaw 已经从你的系统中被彻底请出去了。