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/是否无相关 plistlaunchctl list是否无相关服务
如果以上都清理完毕,基本可以认为已经“干净卸载”。
额外建议(可选添加到博客末尾)
- 若清理后仍有残留,可通过
find ~ -name "*openclaw*" -o -name "*gateway*"全局搜索相关文件,谨慎删除; - 操作前建议备份
~/.openclaw目录(执行cp -r ~/.openclaw ~/openclaw_backup),避免误删数据。
下面是b站里面我录的视频,
【Mac 彻底卸载 OpenClaw 并重装|干净无残留教程】 https://www.bilibili.com/video/BV1PdPyztEv1/?share_source=copy_web&vd_source=969e2d86f42364b8895f6ca77c221e08