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/ 查看列表，避免误删其他服务的 plist。

6. 最终检查清单（快速验证）

使用以下条目逐项确认：

• ~/.openclaw 目录是否已消失
• which openclaw 是否无输出
• ~/Library/LaunchAgents/ 下是否无相关 plist 文件
• launchctl list 结果中是否有 OpenClaw 相关服务

若以上均清理完毕，即可视为“干净卸载”。

额外提醒：若仍有残留，可用 find ~ -name "*openclaw*" -o -name "*gateway*" 全局搜索相关文件，逐一谨慎删除。操作前建议备份 ~/.openclaw 目录（执行 cp -r ~/.openclaw ~/openclaw_backup），防止误删重要数据。

来源：互联网