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 文件。

常见路径：

~/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），避免误删数据。