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

jack.yang

发布于 2026-03-18 08:11:53

5520

💡 前言 很多 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 一定能恢复到安装前的完美状态！

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2026-03-17，如有侵权请联系 cloudcommunity@tencent.com 删除

mac

本文分享自作者个人站点/博客前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度