OpenClaw 卸载不干净？macOS / Windows / Linux 彻底清理指南

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/