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

在 macOS 上卸载 OpenClaw，其实可以拆成几个关键步骤。很多朋友以为把应用拖进废纸篓就完事了，但后台服务和配置文件往往会悄悄留在系统里。下面这份指南，应该能帮你彻底解决这个问题。

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

如果安装时没有完全跳过这个过程，你会发现 OpenClaw 自带一个命令行交互菜单。执行：

openclaw uninstall 

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

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

：四个选项都执行一次。

这样可以确保：

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

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

2. 如果是通过 Homebrew 安装

先确认命令来源：

which openclaw 

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

brew uninstall openclaw 

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

brew autoremove 

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

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

~/.openclaw 

你可以先查看：

cd ~/.openclaw
ls 

常见内容包括：

agents
canvas
completions
credentials
logs
workspace
...

：删除前请确认：

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

确认后执行：

rm -rf ~/.openclaw 

删除后可再次验证：

ls -a ~ | grep openclaw 

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

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

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

npm rm -g openclaw 

验证是否卸载成功：

which openclaw
openclaw --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 

这里有个坑：launchctl 子命令在不同 macOS 版本略有差异。如果不确定文件是否存在，建议先执行 ls ~/Library/LaunchAgents/ 查看列表，避免误删其他服务文件。

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

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

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

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

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