想把电脑上的小龙虾(OpenClaw)清理得一干二净,不留任何后患?这确实是很多用户在尝试或卸载这类工具时最关心的问题。毕竟,一个复杂的应用程序往往会在系统各处留下痕迹,简单的删除操作常常不够彻底。

下面这份指南,将带你一步步完成从停止服务到清除所有残留文件的完整流程,确保你的系统恢复清爽。
OpenClaw 的痕迹
在动手之前,不妨先看看一台安装过 OpenClaw 的电脑,究竟会在哪些地方留下它的“足迹”。结果可能会让你惊讶——它的文件分布相当广泛,从系统目录到用户文件夹,从临时文件到浏览器缓存,无处不在。
下面是通过 fd 命令搜索到的部分文件列表,这直观地展示了为何需要一套系统性的卸载方法:
-> % fd -a -u openclaw
/private/tmp/openclaw/
/private/tmp/openclaw/openclaw-2026-03-12.log
/private/tmp/openclaw/openclaw-2026-03-11.log
/System/Volumes/Data/opt/homebrew/Library/Taps/homebrew/homebrew-cask/Casks/o/openclaw.rb
/System/Volumes/Data/opt/homebrew/bin/openclaw
/private/var/folders/sx/r0j5n9c54gd_6lyxfr3tzhjh0000gn/T/openclaw-501/
/Users/ponponon/Downloads/openclaw.png
/System/Volumes/Data/opt/homebrew/lib/node_modules/openclaw/
/opt/homebrew/lib/node_modules/openclaw/
... (此处省略大量中间路径,包括各种扩展插件、文档、缓存文件等) ...
/System/Volumes/Data/Users/ponponon/.openclaw/openclaw.json
/System/Volumes/Data/Users/ponponon/Library/Application Support/Firefox/Profiles/3qQNDNdX.配置文件 2/storage/default/https+++openclaw-host.com/
/System/Volumes/Data/Users/ponponon/Library/LaunchAgents/ai.openclaw.gateway.plist
/System/Volumes/Data/Users/ponponon/Library/Application Support/Trae/User/globalStorage/.ckg/storage/u_29aee81de6ba02e571c47eaaa2a5886b63188e215bef8239ef7aa9fed9e2cf69/openclaw_ea0e57c9c9441d_1v9bdv_file_cache.db
可以看到,除了主要的程序文件,还有日志、配置文件、浏览器存储、启动袋里(LaunchAgent)以及各种依赖模块。这正是我们需要按顺序执行多个步骤的原因。
怎么彻底卸载
要彻底清除,请按照以下顺序,在终端中依次输入这6个命令。每一步都有其作用,顺序很重要。
1. 停止后台服务
首先,停止任何可能正在运行的 OpenClaw 网关服务,避免文件被占用导致删除失败。
openclaw gateway stop
2. 修复并清理启动项
这个命令会尝试诊断并修复问题,其中关键的一步是清理旧的 LaunchAgent 服务文件,防止它开机自启。
openclaw doctor --repair
3. 卸载 npm 全局包
如果你是通过 npm 安装的,这是卸载主程序包的标准方式。
npm uninstall -g openclaw
4. 卸载 Homebrew 安装包(如果适用)
如果你也通过 Homebrew 安装了它,用这个命令移除。
brew uninstall openclaw
5. 删除用户配置文件和数据
OpenClaw 在用户目录下存放了配置文件、工作空间和补全脚本,需要手动删除。
rm -rf ~/.openclaw
6. 清理临时文件
最后,清除系统临时目录中可能残留的 OpenClaw 相关文件。
rm -rf /tmp/openclaw
验证是否清理干净
完成以上所有步骤后,如何确认卸载成功了呢?方法很简单。
打开终端,输入以下命令:
openclaw --version
如果系统返回的是 command not found: openclaw 或类似的提示,那么恭喜你,OpenClaw 已经从你的系统中被彻底移除了。
反之,如果还能看到版本号信息,则说明仍有残留的安装路径在系统的可执行文件搜索路径($PATH)中,可能需要回头检查上述步骤,特别是第3、4步的卸载是否完全成功,或者检查是否有其他安装方式(如直接下载二进制文件)未被处理。
