macOS彻底卸载OpenClaw完整指南（含深度清理）

在 macOS 上彻底卸载 OpenClaw 其实可以拆分为几个关键操作。很多用户以为把应用拖进废纸篓就大功告成了，但实际后台服务与配置文件往往还会悄悄残留在系统里。下面这份详细的卸载指南，将帮助您实现干净、完整的移除。

1. 优先使用官方内置卸载命令（强烈推荐）

如果当初安装时没有跳过这一环节，您会发现 OpenClaw 自带一个交互式命令行工具。在终端执行：

openclaw uninstall 

在该流程中，通常会列出下列选项（各版本文字描述可能稍有不同）：

• Gateway service（网关 / 后台守护进程）
• State（状态缓存）
• Workspace（工作区数据）
• macOS app（应用程序本体）

建议做法：依次对这四个选项都执行一遍。

这样做能确保：

• 已注册的后台服务被正确注销
• 已申请的权限（如文件访问、网络）被释放
• 官方推荐路径下的所有组件被完整移除

完成这一步之后，如果您仍然希望“彻底清空残留”，可以继续执行下面的深度清理步骤。

2. 若通过 Homebrew 安装，请用 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. 通过 npm 全局安装的 CLI 卸载方法

如果 OpenClaw 的命令行工具是通过 npm 全局安装的：

npm rm -g openclaw 

然后确认卸载是否生效：

which openclaw
openclaw --version 

若终端提示：

command not found 

通常表示已彻底移除。

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

如果 OpenClaw 或其 gateway 以 LaunchAgent 方式开机自启，就需要清理对应的 plist 描述文件。一个容易被忽略的细节：原始笔记里曾出现拼写错误（将 plist 误写为 plis），请以本指南为准。

常见存放路径：

~/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/ 列出全部服务，避免误删其他应用程序的 plist。

6. 最终核查清单（快速确认是否彻底干净）

按以下项目逐一核对，即可判断卸载是否完整：

• ~/.openclaw 目录是否已不存在
• which openclaw 是否无任何输出
• ~/Library/LaunchAgents/ 中是否无任何与 openclaw 相关的 plist 文件
• launchctl list 输出中是否已无相关服务名

如果以上四项均确认无误，基本可以认为已经完成了“干净卸载”。

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