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),避免误删数据。
到此这篇关于macOS 完整卸载OpenClaw 指南(含深度清理)的文章就介绍到这了,更多相关macOS完整卸载OpenClaw 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
