Mac 用户必看：OpenClaw 彻底卸载全攻略

💡 前言
很多 Mac 用户安装了 OpenClaw想卸载时遇到“删不干净”的怪事：

❌ 拖进废纸篓后，终端一打开又自动启动？

❌ 后台进程关了又冒出来？

❌ 提示 command not found 却仍有残留进程？

真相是： OpenClaw 不是普通 App，它是一套由 Node CLI + Gateway 服务 + launchd 自启 + Shell Hook 组成的复杂系统。只删图标是没用的！

本文提供**「官方简易版」和「手动彻底版」两套方案，附带一键脚本和验证命令**。全程免费，手把手教你把 Mac 恢复清爽！

🔍 第一步：知己知彼（它到底藏在哪？）

在动手前，先了解 OpenClaw 的“藏身之处”，避免漏删：

组件类型	藏身位置	作用	是否容易残留
GUI 应用	`/Applications/OpenClaw.app`	桌面图标	⭐ (易删)
CLI 命令	`/usr/local/bin` 或 Node 全局包	终端命令 `openclaw`	⭐⭐
后台服务	`~/Library/LaunchAgents/`	开机自启、守护进程	⭐⭐⭐ (高危)
配置数据	`~/.openclaw`	缓存、Workspace、配置	⭐⭐⭐ (占空间)
Shell Hook	`~/.zshrc` / `~/.bashrc`	终端启动时自动加载	⭐⭐⭐⭐ (最隐蔽)
Node Shim	`~/.nodenv` / `~/.nvm`	版本管理器生成的映射	⭐⭐⭐⭐ (最顽固)

⚠️ 核心警告：绝大多数“删不干净”的问题，都是因为漏掉了 Shell Hook 和 Node Shim。

🚀 方案一：官方简易卸载（适合新手/快速尝试）

如果你的 openclaw 命令还能正常使用，可以先尝试官方自带的卸载工具。它能清除 80% 的核心组件。

打开终端，执行以下任一命令：

# 标准卸载（需手动确认）
openclaw uninstall

# 懒人模式（自动确认，强制删除所有关联项）
openclaw uninstall --all --yes --non-interactive

✅ 它能删除什么？

Gateway 服务
CLI 程序
配置文件 (~/.openclaw)
App 图标
Docker 容器

❌ 它的局限性：
往往无法清理 Shell 自动加载代码 和 Node Shim。如果你执行后发现终端仍有异常，请务必继续执行方案二。

🛠️ 方案二：手动彻底卸载（推荐！根除所有残留）

无论方案一是否成功，建议按顺序执行以下 5 个步骤，确保 100% 清理干净。

1️⃣ 停止后台服务（必须先做！）

如果不先停止服务，后续删除文件会报错“文件被占用”。

# 如果 CLI 还能用
openclaw gateway stop

# 如果 CLI 已失效，强制停止 launchd 服务
launchctl bootout gui/$UID/ai.openclaw.gateway

2️⃣ 删除自启动配置 (LaunchAgents)

防止开机自动运行或进程复活。

# 删除主配置文件
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

# 删除可能存在的其他 Profile 配置
rm -f ~/Library/LaunchAgents/ai.openclaw.*.plist

3️⃣ 清空配置与数据目录

释放磁盘空间，清除所有缓存和历史记录。

# 删除主配置目录
rm -rf ~/.openclaw

# 删除多 Profile 目录（如果有）
rm -rf ~/.openclaw-*

# 删除工作区临时数据
rm -rf ~/.openclaw/workspace

4️⃣ 卸载 CLI 命令

根据你当初的安装方式（npm/pnpm/bun），执行对应命令（全部执行一遍也无妨）。

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

# 暴力补刀：如果上述命令无效，直接删除二进制文件
rm -f /usr/local/bin/openclaw
rm -f /opt/homebrew/bin/openclaw

5️⃣ 删除 GUI 应用

rm -rf /Applications/OpenClaw.app

💣 关键步骤：清理隐蔽残留（90% 的人漏掉这里！）

做完上面几步，如果终端打开仍有反应，问题一定出在这里。

🔸 清理 Shell 自动加载 (Shell Hook)

安装时它修改了你的配置文件，每次开终端都会自动运行脚本。

编辑配置文件（Zsh 用户）：
```
nano ~/.zshrc
```
(Bash 用户请改为 nano ~/.bashrc)
查找并删除：
找到包含 openclaw 的行（通常长这样）：
```
source <(openclaw completion ...)
# 或者
eval "$(openclaw init ...)"
```
操作：按 Ctrl + K 删除该行 -> 按 Ctrl + O 保存 -> 按 Enter 确认 -> 按 Ctrl + X 退出。
立即生效：
```
source ~/.zshrc
```

🔸 清理 Node Shim (顽固分子)

如果你使用了 nvm, nodenv, asdf 等版本管理器，它们生成的 shim 文件会自动重建命令。

# 删除 nodenv 的 shim
rm -f ~/.nodenv/versions/*/bin/openclaw
nodenv rehash

# 删除 nvm 的 shim (如果有)
# 注意：nvm 通常不需要手动删 shim，卸载全局包即可，但可检查
ls ~/.nvm/versions/node/*/bin/openclaw 
# 如果有文件，手动 rm 删除

✅ 终极验证：真的删干净了吗？

执行以下 3 条命令，全部通过才算成功：

# 1. 检查命令是否存在 (应返回空或 not found)
which openclaw

# 2. 检查后台服务 (应无输出)
launchctl list | grep openclaw

# 3. 检查残留文件 (应无输出)
ls -a ~ | grep openclaw

🎉 如果以上都没有输出，恭喜！你的 Mac 已经彻底清爽了！

⚡ 进阶选项：一键卸载脚本（懒人专用）

如果你熟悉终端操作，可以直接运行这个脚本，一次性完成所有步骤。

复制以下代码，保存为 clean_openclaw.sh 并运行：

#!/usr/bin/env zsh
echo "🧹 开始彻底清理 OpenClaw..."

# 1. 停止服务
launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/null

# 2. 删除文件与配置
rm -rf ~/.openclaw ~/.openclaw-* 
rm -rf ~/Library/LaunchAgents/ai.openclaw*
rm -rf /Applications/OpenClaw.app

# 3. 卸载 CLI
npm rm -g openclaw 2>/dev/null
pnpm remove -g openclaw 2>/dev/null
bun remove -g openclaw 2>/dev/null
rm -f /usr/local/bin/openclaw /opt/homebrew/bin/openclaw

# 4. 清理 Shim
rm -f ~/.nodenv/versions/*/bin/openclaw
nodenv rehash 2>/dev/null

echo "✅ 清理完成！请手动检查 ~/.zshrc 是否还有 openclaw 相关代码。"

运行方法：

chmod +x clean_openclaw.sh
./clean_openclaw.sh

(注：脚本无法自动修改 .zshrc 内容，运行后请务必手动检查该文件！)

🆘 常见问题急救 (FAQ)

💡 总结
彻底卸载 OpenClaw 的核心不在于“删 App”，而在于断链：

断服务 (launchctl)
断命令 (npm rm + rm bin)
断自启 (LaunchAgents + .zshrc)
断映射 (Node Shim)

按照本文步骤操作，你的 Mac 一定能恢复到安装前的完美状态！

posted @ 2026-03-17 11:34 JackYang 阅读(0) 评论(0) 收藏举报

刷新页面返回顶部