夜雨聆风🦞保姆级教程彻底卸载 OpenClaw手把手教你无残留卸载，告别"小龙虾"🪟 Windows🍎 macOS🐧 Linux
⚠️ 卸载前请务必备份卸载操作将删除 ~/.openclaw 目录下的所有配置和数据，包括你的智能体工作区。如有重要数据，请先手动备份。
📑 本文目录1. 一键命令卸载（推荐首选）2. 🪟 Windows 手动卸载3. 🍎 macOS 手动卸载4. 🐧 Linux 手动卸载5. 📦 通过 npm / pnpm 安装的卸载方式6. 验证是否卸载干净7. 常见问题 FAQ
① 一键命令卸载推荐
💡 适用条件你能在终端中正常运行 openclaw 命令，说明 CLI 尚未被删除，可以直接用内置命令卸载。
步骤 1：打开终端，执行卸载命令
运行下方命令，按照交互式提示完成卸载。系统会自动停止服务、清理配置文件。
BASH
openclawuninstall
步骤 2：静默全量卸载（非交互式）
如果你希望跳过所有确认提示，一键自动完成全部步骤：
BASH
openclawuninstall--all --yes --non-interactive
也可用 npx 方式（无需本地安装也能运行）：
BASH
npx-y openclaw uninstall --all --yes --non-interactive
② 🪟 Windows 手动卸载
CLI 命令已不可用时，手动清除计划任务和残留文件
🔐 需要管理员权限以下命令需要以 管理员身份 运行 CMD 或 PowerShell。右键点击开始菜单 → 选择「Windows PowerShell（管理员）」。
方法 A：使用 PowerShell推荐
以管理员身份打开 PowerShell，依次执行以下两条命令：
POWERSHELL
# 第一步：删除 OpenClaw 后台计划任务Unregister-ScheduledTask-TaskName "OpenClaw Gateway" -Confirm:$false# 第二步：删除数据目录和配置文件Remove-Item-Path "$env:USERPROFILE.openclaw" -Recurse -Force
方法 B：使用命令提示符（CMD）管理员运行
以管理员身份打开 CMD（搜索 cmd → 右键 → 以管理员身份运行）：
CMD
:: 删除计划任务schtasks/Delete /F /TN "OpenClaw Gateway":: 删除数据目录rmdir/s /q "%USERPROFILE%.openclaw"
卸载 CLI 本体
根据你当初安装 OpenClaw 的方式，执行对应命令：
BASH
# 如果通过 npm 安装npmuninstall-g openclaw# 如果通过 pnpm 安装pnpmremove-g openclaw# 如果通过 bun 安装bunremove-g openclaw
③ 🍎 macOS 手动卸载
移除 launchd 服务 + 清理残留文件
步骤 1：停止并移除后台服务
打开终端（Terminal），执行以下命令停止 OpenClaw 的 launchd 守护进程：
BASH
# 停止 Gateway 服务launchctl bootout gui/$UID/bot.molt.gateway# 删除服务配置文件rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist
步骤 2：清理旧版本残留文件
如果之前安装过旧版，还需要清除旧版遗留的配置文件：
BASH
# 清理旧版 plist 文件rm -f ~/Library/LaunchAgents/com.openclaw.*.plist
步骤 3：删除数据目录和桌面应用
删除所有数据文件夹，以及 macOS 桌面端应用（如有安装）：
BASH
# 删除数据和配置目录rm -rf ~/.openclaw# 如果安装了桌面 App，一并删除rm -rf /Applications/OpenClaw.app
步骤 4：卸载 CLI 本体
BASH
# npm 安装npmuninstall-g openclaw# pnpm 安装pnpmremove-g openclaw
④ 🐧 Linux 手动卸载
停用 systemd 服务 + 删除残留数据
步骤 1：停止并禁用 systemd 服务
打开终端，执行以下命令停止 OpenClaw 的用户级系统服务并禁用自启：
BASH
# 停止服务并禁用开机自启systemctl--user disable --now openclaw-gateway.service
步骤 2：删除服务文件并重载守护进程
BASH
# 删除 service 单元文件rm -f ~/.config/systemd/user/openclaw-gateway.service# 重载 systemd 配置systemctl --user daemon-reload
步骤 3：清理数据目录 + 卸载 CLI
BASH
# 删除所有配置和数据rm-rf ~/.openclaw# 卸载 CLI（根据安装方式选择）npmuninstall-g openclaw# 或pnpmremove-g openclaw
⑤ 📦 通过源码 / Git 安装的卸载方式
通过 git clone 安装的用户适用
步骤 1：先按平台停止服务
参照上方 macOS / Linux / Windows 对应章节，先执行停止和卸载 Gateway 服务的步骤。
步骤 2：删除源码目录和数据目录
BASH
# 删除 git 克隆的源码目录（替换为你实际的目录路径）rm -rf ~/openclaw# 删除数据目录rm -rf ~/.openclaw
⑥ ✅ 验证是否卸载干净
执行以下命令，全部报错/无输出即代表卸载成功
🔍 检查 CLI 是否残留
| ⚙️ 检查版本（应报错）
|
📁 检查数据目录
| 🔧 Linux：检查服务
|
🎉 卸载成功的标志以上命令均返回「命令未找到」或「No such file or directory」，说明 OpenClaw 已被彻底清除，系统干净如初！
⑦ ❓ 常见问题 FAQ
卸载过程中遇到问题？看这里
Q 使用了 --profile 参数，数据在哪里？如果你启动时指定了 --profile myprofile，数据目录为 ~/.openclaw-myprofile，需要额外手动删除：rm -rf ~/.openclaw-myprofile
Q 在远程服务器上部署了 OpenClaw，如何卸载？如果 Gateway 运行在远程主机上，需要 SSH 登录到该远程主机，在远程机上执行对应平台的停止服务命令（步骤 1-3）来清理网关进程和状态数据。
Q 卸载后还想重新安装怎么办？直接按官方文档重新安装即可。卸载已清除所有旧配置，新安装是全新干净状态，不会有残留冲突。
Q Windows 提示「找不到任务」怎么办？说明计划任务已不存在，可以直接跳过该步骤，继续删除数据目录即可。不影响最终卸载结果。
Q macOS 执行 launchctl bootout 报错怎么办？报错说明该服务本就未在运行，可以直接跳过这一步，继续删除 .plist 文件和数据目录，不影响卸载流程。
🧹 卸载完成，系统焕然一新！如果本教程帮助到了你，欢迎转发给同样需要的朋友有任何问题，留言告诉我们 👇 #OpenClaw#卸载教程 #保姆级教程