macOS完整卸载OpenClaw指南小结(含深度清理)

macOS完整卸载OpenClaw指南小结(含深度清理)并不只看表面做法，关键还要理解相关条件、限制和后续影响。

1. 先用应用内的卸载功能（推荐）

在 OpenClaw 的：

openclaw uninstall 

流程里，通常会看到类似选项（不同版本文案可能略有差异）：

1. Gateway service（网关 / 后台服务）
2. State（状态数据）
3. Workspace（工作区）
4. macOS app（应用本体）

✅ 建议做法

四个选项都执行一次。

这样可以确保：

1. 已注册的后台服务被正确注销
2. 已申请的权限被释放
3. 官方推荐路径下的组件被完整移除

完成后，如果你仍想“卸载干净”，再继续下面的深度清理步骤。

2. 如果是通过 Homebrew 安装

先确认命令来源：

which openclaw 

如果路径来自 Homebrew（例如 /opt/homebrew/bin/openclaw），执行：

brew uninstall openclaw 

如需进一步清理无用依赖（可选）：

brew autoremove 

3. 深度清理残留文件（可选）

OpenClaw 默认会在用户目录下创建配置与工作区：

~/.openclaw 

你可以先查看：

cd ~/.openclawls 

常见内容包括：

agentscanvascompletionscredentialslogsworkspace...

⚠️ 注意

删除前请确认：

1. 不再需要其中的 workspace 数据
2. 不需要保存历史配置或日志

确认后执行：

rm -rf ~/.openclaw 

删除后可再次验证：

ls -a ~ | grep openclaw 

若无输出，说明目录已移除。

4. 卸载 OpenClaw CLI（npm 全局安装）

如果你是通过 npm 全局安装的 CLI：

npm rm -g openclaw 

验证是否卸载成功：

which openclawopenclaw --version 

若提示：

command not found 

通常表示已成功移除。

5. 移除 macOS 后台服务（LaunchAgent）

如果 OpenClaw 或其 gateway 以 LaunchAgent 形式启动，需要清理对应的 plist 文件。

你原笔记里有个小拼写错误：plis → plist

常见路径：

~/Library/LaunchAgents/ 

例如：

rm -f ~/Library/LaunchAgents/bai.openclaw.gateway.plist 

如果服务仍在运行

先查看：

launchctl list | grep -i gateway 

找到对应 label 后执行：

launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/ai.openclaw.gateway.plist 

注意：

1. launchctl 子命令在不同 macOS 版本略有差异
2. 如果不确定文件是否存在，建议先：

ls ~/Library/LaunchAgents/ 

避免误删其他服务文件。

6. 最终检查清单（快速确认）

可以用下面几项做最终核对：

1. ~/.openclaw 是否不存在
2. which openclaw 是否无输出
3. ~/Library/LaunchAgents/ 是否无相关 plist
4. launchctl list 是否无相关服务

如果以上都清理完毕，基本可以认为已经“干净卸载”。

额外建议（可选添加到博客末尾）

1. 若清理后仍有残留，可通过 find ~ -name "*openclaw*" -o -name "*gateway*" 全局搜索相关文件，谨慎删除；
2. 操作前建议备份 ~/.openclaw 目录（执行 cp -r ~/.openclaw ~/openclaw_backup），避免误删数据。