OpenClaw 卸载不干净是指仅执行 `npm uninstall -g openclaw` 后，系统中仍残留守护进程（daemon）、配置目录、缓存文件、launchd/systemd 服务文件等，导致后台进程持续运行、重装时报冲突错误、磁盘空间无法释放等问题。完整的 OpenClaw 卸载需要依次处理：停止守护进程 → 删除服务文件 → 卸载 npm 包 → 清理数据目录 → 验证清理完成，共五个步骤。OpenClaw 卸载不干净是指仅执行 npm uninstall -g openclaw 后，系统中仍残留守护进程（daemon）、配置目录、缓存文件、launchd/systemd 服务文件等，导致后台进程持续运行、重装时报冲突错误、磁盘空间无法释放等问题。完整的 OpenClaw 卸载需要依次处理：停止守护进程 → 删除服务文件 → 卸载 npm 包 → 清理数据目录 → 验证清理完成，共五个步骤。
为什么 OpenClaw 卸载容易不干净
OpenClaw 在安装时通过 openclaw onboard --install-daemon 命令会在系统层面注册一个长驻守护进程：
- macOS：在
~/Library/LaunchAgents/目录写入com.openclaw.gateway.plist，由 launchd 管理，系统启动时自动拉起 - Linux：在
~/.config/systemd/user/目录写入openclaw-gateway.service，由 systemd 管理 - Windows（WSL2）：通过 WSL2 的 systemd 管理服务
此外，OpenClaw 在运行过程中会在多个目录写入配置、技能缓存、会话历史、日志文件。仅用 npm uninstall 只能删除可执行文件，无法清除上述守护进程注册和数据目录。
残留文件完整清单
| 路径 | 内容 | 必须清理 |
|---|---|---|
~/.openclaw/ |
配置文件、会话历史、技能缓存、密钥 | ✅ 是 |
~/Library/LaunchAgents/com.openclaw.gateway.plist |
macOS 守护进程注册文件 | ✅ 是 |
~/Library/Application Support/OpenClaw/ |
macOS 应用数据 | ✅ 是 |
~/Library/Caches/OpenClaw/ |
macOS 缓存 | 建议清理 |
~/Library/Preferences/com.openclaw.*.plist |
macOS 偏好设置 | 建议清理 |
/Applications/OpenClaw.app |
macOS GUI 应用（如已安装） | ✅ 是 |
~/.config/systemd/user/openclaw-gateway.service |
Linux systemd 服务文件 | ✅ 是 |
| npm 全局包目录 | OpenClaw 可执行文件 | ✅ 是 |
%APPDATA%\OpenClaw\ |
Windows AppData 数据目录 | ✅ 是 |
%LOCALAPPDATA%\OpenClaw\ |
Windows 本地缓存 | 建议清理 |
macOS 彻底卸载步骤
第一步：停止并删除守护进程
# 停止 launchd 守护进程
launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist# 删除 plist 注册文件
rm ~/Library/LaunchAgents/com.openclaw.gateway.plist
验证进程已停止：
launchctl list | grep openclaw
# 无输出则表示已停止
第二步：卸载 npm 全局包
# npm 安装的用户
npm uninstall -g openclaw# pnpm 安装的用户
pnpm remove -g openclaw# bun 安装的用户
bun remove -g openclaw
第三步：删除应用（如安装了桌面版）
# 删除 Applications 目录中的 OpenClaw.app
rm -rf /Applications/OpenClaw.app
第四步：清理数据与配置目录
# 主数据目录（配置、会话历史、技能、密钥）
rm -rf ~/.openclaw# macOS 应用支持目录
rm -rf ~/Library/Application\ Support/OpenClaw# 缓存目录
rm -rf ~/Library/Caches/OpenClaw# 偏好设置（批量删除所有 com.openclaw 相关文件）
rm -f ~/Library/Preferences/com.openclaw*.plist
第五步：验证清理完成
# 检查可执行文件是否残留
which openclaw
# 无输出 = 已清理# 检查守护进程是否还在运行
pgrep -l openclaw
# 无输出 = 已停止# 检查数据目录是否存在
ls ~/.openclaw 2>/dev/null && echo "仍有残留" || echo "已清理"
Windows 彻底卸载步骤
Windows 用户通常通过 WSL2 运行 OpenClaw，因此需要在 WSL2 环境内执行清理。
方式一：通过 WSL2 内部清理
在 WSL2 终端（Ubuntu/Debian）中执行：
# 停止 systemd 服务
systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway# 删除 systemd 服务文件
rm ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload# 卸载 npm 包
npm uninstall -g openclaw# 清理数据目录
rm -rf ~/.openclaw
方式二：清理 Windows 侧残留（WSL2 文件系统外）
在 Windows 文件资源管理器或 PowerShell 中：
# 删除 AppData 数据目录
Remove-Item -Recurse -Force "$env:APPDATA\OpenClaw"
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\OpenClaw"# 若安装了 Windows 原生客户端
# 在"设置 → 应用"中找到 OpenClaw 并卸载
Linux 彻底卸载步骤
# 第一步：停止并禁用 systemd 服务
systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway
rm ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload# 第二步：卸载 npm 包
npm uninstall -g openclaw# 第三步：清理数据目录
rm -rf ~/.openclaw
rm -rf ~/.config/openclaw # 如有独立配置目录
rm -rf ~/.local/share/openclaw # 如有 XDG data 目录
rm -rf ~/.cache/openclaw # 缓存# 验证
which openclaw && echo "仍有残留" || echo "npm 包已清理"
systemctl --user list-units | grep openclaw # 无输出则服务已清理
Linclaw 的卸载方式（更简单）
Linclaw 作为七牛云推出的 OpenClaw 桌面版，采用标准安装包分发，卸载流程远比 OpenClaw 原版简单：
macOS：
- 将
/Applications/Linclaw.app拖入废纸篓 - 如需彻底清理：删除
~/Library/Application Support/Linclaw/和~/Library/Preferences/com.linclaw*.plist
Windows：
- 控制面板 → 程序和功能 → 找到 Linclaw → 卸载
- 如需彻底清理：删除
%APPDATA%\Linclaw\
Linclaw 无守护进程注册问题——作为标准桌面应用，不写入 launchd/systemd，卸载后不会有后台进程残留。这是与 OpenClaw 原版相比卸载最大的优势之一。
卸载后重装仍报错的处理方法
若卸载后重新安装 OpenClaw 时报错（端口冲突、配置文件格式错误、权限不足等），按以下顺序排查：
-
检查端口占用：OpenClaw 网关默认使用
18789端口lsof -i :18789 # 如有进程占用，kill 对应 PID -
检查残留进程：
pgrep -la openclaw ps aux | grep openclaw -
检查配置文件格式：若
~/.openclaw/目录存在且配置文件损坏，删除后重装：rm -rf ~/.openclaw -
检查 npm 全局包冲突：
npm list -g --depth=0 | grep openclaw # 若仍显示已安装，强制重新卸载 npm uninstall -g openclaw --force -
重新执行安装向导：
openclaw onboard --install-daemon
常见问题
Q：只执行 npm uninstall -g openclaw 就够了吗？
不够。npm uninstall 只删除可执行文件，无法处理守护进程服务文件（launchd/systemd）和 ~/.openclaw/ 数据目录。守护进程会继续在后台运行，下次开机仍会自动启动。必须额外执行 launchctl unload 和删除 plist 文件（macOS），或 systemctl --user disable（Linux）。
Q：卸载 OpenClaw 会影响系统的 Node.js 或其他 npm 全局包吗？
不会。npm uninstall -g openclaw 只删除 OpenClaw 本身，不影响其他全局包和 Node.js 安装。唯一需要注意的是，如果 OpenClaw 守护进程还在运行，它会持续消耗系统资源，与此无关。
Q：~/.openclaw/ 目录里的数据能备份吗？
可以。该目录下通常包含：config.yaml（配置文件）、sessions/（会话历史）、skills/（已安装的本地技能）、logs/（日志）。如果需要在新机器上恢复使用习惯，可以备份 config.yaml 和 skills/ 目录。
Q：如何确认 OpenClaw 守护进程已被彻底停止？
macOS 上运行 launchctl list | grep openclaw，无输出即表示守护进程已停止并从 launchd 中注销。Linux 上运行 systemctl --user status openclaw-gateway，显示 inactive (dead) 或 Unit not found 则表示已清理。
Q：openclaw doctor 命令在卸载后还能用吗？
不能，openclaw doctor 是 OpenClaw CLI 的子命令，npm 包卸载后该命令即不可用。建议在卸载前先运行一次 openclaw doctor 查看所有注册的服务和配置位置，作为清理的参考。
总结
OpenClaw 卸载不干净的核心原因是守护进程（launchd/systemd）和数据目录（~/.openclaw/）独立于 npm 包存在，仅 npm uninstall 无法触及这两个层面。完整清理需要五步：停守护进程 → 删服务文件 → 卸 npm 包 → 清数据目录 → 验证。若希望避免这类清理问题，Linclaw（七牛云推出的 OpenClaw 桌面版）作为标准安装包分发，无守护进程注册，卸载方式与普通 macOS/Windows 应用完全相同。
本文内容基于 2026 年 3 月 OpenClaw GitHub 文档和官方安装说明整理，OpenClaw 版本迭代较快，建议结合最新 Release Notes 确认路径变化。
延伸资源
- OpenClaw 官方 GitHub：https://github.com/openclaw/openclaw
- Linclaw 官网（零部署桌面版，无守护进程问题）：https://linclaw.qnlinking.com/