夜雨聆风更麻烦的是，不同系统（Windows、macOS、Linux）、不同安装方式（npm、git源码、一键脚本），卸载步骤还不一样，新手跟着零散教程操作，很容易漏步、留残留，后续装其他软件还可能出现冲突。
今天整理一份「OpenClaw彻底卸载保姆级指南」，覆盖三大系统、所有安装方式，从基础卸载、残留清理，到常见报错解决，全程干货无废话，命令可直接复制，新手跟着走，轻松实现无残留卸载，再也不用为残留问题内耗～
重点标注避坑点，结合官方卸载规范和实测经验，兼顾实用性和易懂性，不管你是新手还是有一定操作基础，都能快速上手，建议收藏备用！
一、卸载前必做：2步准备，避免卸载失败（重中之重）
卸载前先做好这2步，能有效避免服务占用、文件锁定，减少残留和报错，新手一定要重视，别直接跳过！
1. 停止OpenClaw相关服务（必做）
如果OpenClaw正在运行，或开启了开机自启，直接卸载会导致服务残留、文件无法删除，先停止所有相关服务：
所有系统通用命令（终端/PowerShell/CMD输入，直接复制）：
# 停止守护进程
openclaw daemon stop
# 停止Gateway服务（若安装了网关）
openclaw gateway stop
⚠️ 避坑点：如果提示“command not found”，说明OpenClaw已部分卸载或未全局安装，直接跳过这一步，进入后续卸载流程即可。
2. 备份配置文件（可选，按需操作）
如果后续还可能重新安装OpenClaw，建议先备份配置文件（含密钥、自定义设置），避免重新配置麻烦；若确定不再使用，可直接跳过：
- macOS/Linux：配置文件路径 ~/.openclaw/ ，复制该文件夹到桌面或其他安全位置即可；
- Windows：配置文件路径 %USERPROFILE%\.openclaw\ ，打开此路径，复制文件夹备份即可。
二、分系统卸载：三大系统实操步骤（新手直接抄作业）
核心原则：先卸载主程序，再清理残留，不同系统操作略有差异，按自己的系统对应操作，命令可直接复制，无需手动输入，降低出错概率。
1. Windows系统（含WSL2，覆盖CMD/PowerShell安装）
Windows用户注意：无论是CMD、PowerShell一键安装，还是npm全局安装，卸载核心步骤一致，重点清理残留文件即可。
步骤1：卸载OpenClaw主程序（终端/PowerShell/CMD输入）
# 优先使用官方一键卸载命令（最彻底）
openclaw uninstall --all --yes --non-interactive
# 若上述命令失效，用npm卸载（适用于npm安装方式）
npm uninstall -g openclaw
# 若npm命令也失效，用npx临时调用卸载
npx -y openclaw uninstall --all --yes --non-interactive
步骤2：验证主程序是否卸载成功
# PowerShell输入
Get-Command openclaw -ErrorAction SilentlyContinue
# CMD输入
where openclaw
⚠️ 验证标准：无任何输出，或提示“无法找到文件”，说明主程序已卸载成功。
步骤3：清理残留文件（彻底无残留关键一步）
复制以下命令，在PowerShell中逐一运行，删除配置、源码及遗留脚本：
# 删除配置目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
# 删除git源码目录（若为git方式安装）
Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw"
# 删除遗留包装脚本
Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.cmd" -ErrorAction SilentlyContinue
# 删除旧版残留目录（如clawdbot、moltbot）
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.moltbot" -ErrorAction SilentlyContinue
步骤4：删除计划任务（若开启了开机自启）
schtasks /Delete /F /TN "OpenClaw Gateway" -ErrorAction SilentlyContinue
2. macOS/Linux系统（覆盖npm、git、一键脚本安装）
macOS和Linux系统操作基本一致，终端命令通用，重点区分“npm安装”和“git源码安装”的残留清理差异。
步骤1：卸载OpenClaw主程序（终端输入）
# 官方一键卸载（优先推荐，彻底无遗漏）
openclaw uninstall --all --yes --non-interactive
# 若失效，按安装方式选择对应命令
# npm安装方式
npm uninstall -g openclaw
# pnpm安装方式（若使用pnpm）
pnpm remove -g openclaw
# git源码安装方式（需先删除源码目录）
rm -rf ~/openclaw && npm uninstall -g openclaw
步骤2：验证主程序是否卸载成功
which openclaw
⚠️ 验证标准：提示“not found”或无任何输出，即为成功。
步骤3：清理残留文件（终端逐一输入）
# 删除配置目录（核心残留）
rm -rf ~/.openclaw
# 清理npm残留目录（可选，避免版本冲突）
rm -rf "$(npm root -g)/openclaw"
# 删除旧版残留目录
rm -rf ~/.clawdbot ~/.moltbot ~/.molthub
# macOS额外清理应用程序（若安装了桌面端）
rm -rf /Applications/OpenClaw.app
步骤4：清理系统服务（macOS专属）
# 停止并删除网关服务plist文件
launchctl remove ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
三、常见卸载报错：3类高频问题，直接套用解决方案
卸载过程中难免遇到报错，整理了3类最常见的情况，对应解决方案直接套用，不用复杂排查，新手也能轻松解决。
1. 报错“Permission denied”（权限不足）
原因：没有足够的权限删除文件或停止服务，解决方案：
- Windows：以管理员身份打开PowerShell/CMD，重新运行卸载命令；
- macOS/Linux：在命令前加sudo（如sudo npm uninstall -g openclaw），输入密码后即可执行。
2. 报错“服务无法停止”“文件被占用”
原因：OpenClaw相关进程正在运行，锁定了文件，解决方案：
# Windows（PowerShell）：终止相关进程
Get-Process | Where-Object {$_.Name -match "claw"} | Stop-Process -Force
# macOS/Linux（终端）：终止相关进程
ps aux | grep claw | grep -v grep | awk '{print $2}' | xargs kill -9
执行后，重新运行卸载命令即可。
3. 卸载后仍能查到OpenClaw命令（残留）
原因：未清理环境变量或残留脚本，解决方案：
- Windows：重启终端，若仍有提示，清理环境变量（删除Path中含“openclaw”的路径）；
- macOS/Linux：终端输入source ~/.bashrc（bash终端）或source ~/.zshrc（zsh终端），刷新环境变量即可。
四、卸载后收尾：2步确认，确保彻底无残留
卸载完成后，建议做这2步确认，避免残留文件占用内存，或影响后续软件安装：
1. 再次验证：终端输入openclaw --version，若提示“command not found”，说明主程序已彻底卸载；
2. 清理缓存：所有系统通用命令，终端输入npm cache clean --force，清理npm缓存，避免残留文件冲突。
五、补充提醒（新手必看）
1. 卸载顺序：先停止服务 → 卸载主程序 → 清理残留 → 验证，切勿颠倒顺序，否则易出现残留；
2. 源码安装卸载：若通过git clone安装，需先删除git克隆目录（如~/openclaw），再卸载全局包；
3. 第三方衍生版本：如AutoClaw、QClaw等，需单独卸载（Windows在设置→应用中卸载，macOS拖入废纸篓），并清理对应配置目录（如~/.autoclaw）；
4. 无需过度清理：正常按步骤操作，即可实现无残留，无需使用第三方清理工具，避免误删系统文件。
最后总结
OpenClaw卸载的核心的是“先停服务、再卸主程序、最后清残留”，不同系统、不同安装方式，只需对应调整命令，就能轻松实现无残留卸载。
新手不用怕操作复杂，所有命令均可直接复制，按步骤执行，遇到报错直接套用解决方案，就能告别残留烦恼。
收藏这份指南，下次卸载OpenClaw不用再到处找教程，全程高效不踩坑，轻松清理多余软件，释放电脑内存～
