Uninstall guide
一张卸载页，把检查、停服务、删残留这三步拆清楚
不管你是本地电脑还是云服务器，这里都先教你确认 OpenClaw 还在不在，再决定走一键卸载还是手动清理， 让小白也能按顺序把环境收干净。
覆盖系统
Win / macOS / Linux
云端场景
Ubuntu VPS
优先策略
先检测再卸载
兜底方式
手动清理残留
Uninstall guide
需要卸载 OpenClaw 时，也给你一套能照着做完的流程
这里优先给出一键卸载命令；如果命令已经不在，但服务或残留目录还在，也给出手动清理路径。Windows、macOS、Linux 和云服务器都分开写清楚。
Step 01
先确认当前系统或服务器
Step 02
检查 CLI / 服务是否还存在
Step 03
优先执行一键卸载
Step 04
如果残留未清干净，再走手动清理
卸载前先确认
- • 先确认你是在 WSL2 的 Ubuntu 里运行 OpenClaw 还是在原生 Windows 里留了计划任务。
- • 如果你还想保留数据备份，可先执行 `openclaw backup create`。
- • 下面的删除命令会清掉状态目录与工作区，确认没有要保留的数据再执行。
看到这些结果，说明已经卸载干净
`openclaw --version` 提示找不到命令，说明 CLI 已移除。
`schtasks /Query /TN "OpenClaw Gateway"` 查不到任务，说明 Windows 残留服务也清掉了。
`~/.openclaw` 或自定义状态目录已经不存在，说明状态文件已清理完成。
需要一对一帮你卸载？
如果你担心卸载不干净、重装前想先清理干净，或者服务删不掉，可以直接扫码加我微信处理。
先检查
先看命令是否还存在、服务是否还在，再决定走一键卸载还是手动清理。
Ubuntu 内确认 `openclaw` 是否还存在
如果还能看到版本号，优先走一键卸载。
openclaw --version || echo "openclaw missing"
openclaw gateway status || truePowerShell 检查是否残留 Windows 计划任务
如果查不到任务，会看到报错；有结果则说明还残留 Windows 服务脚本。
schtasks /Query /TN "OpenClaw Gateway"推荐顺序
01大多数 Windows 用户先进入 WSL2 的 Ubuntu 终端，把 OpenClaw 当作 Linux 环境来卸载。
02如果 `openclaw --version` 还能执行，直接走一键卸载最省事。
03一键卸载完成后，再执行 `npm rm -g openclaw`，这样 CLI 也会一起移除。
04如果 Ubuntu 里命令已经没了，但 Windows 里还残留计划任务，再回到 PowerShell 执行手动清理命令。
优先一键卸载
命令还能执行时，先走这一列；如果命令丢了但服务还在，再看下面的手动清理。
1. 可选：先备份当前状态
openclaw backup create2. 在 Ubuntu 终端执行一键卸载
这一步会卸载 Gateway 服务并删除本地状态与工作区；CLI 本体还在。
openclaw uninstall --all --yes3. 删除全局 CLI
npm rm -g openclaw命令不在时再手动清理
如果 `openclaw` 已经找不到，但服务、目录或计划任务还残留，就按这一列继续。
A. Ubuntu 内手动停止并卸载 Gateway
如果你用了自定义 `OPENCLAW_CONFIG_PATH`，把那个配置文件也一并删掉。
openclaw gateway stop
openclaw gateway uninstall
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"B. 删除工作区与 CLI
rm -rf ~/.openclaw/workspace
npm rm -g openclawC. 若残留 Windows 计划任务，用 PowerShell 清理
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"补充说明
- • 如果你用了 profile，状态目录可能是 `~/.openclaw-<profile>`，需要按实际目录重复删除。
- • 如果你只是想重装，不一定非要删掉 CLI；也可以只用 `openclaw uninstall --all --yes` 先清状态和服务。
Direct contact
卸载不干净，或者想让我直接帮你清掉？
如果你遇到服务删不掉、目录残留、端口还被占着，或者准备重装前想先彻底清理干净，可以直接扫码联系我。
微信直接沟通
扫码后可直接沟通安装、部署和场景落地。
参考来源
卸载命令、平台清理路径与服务处理方式优先以 OpenClaw 官方文档为准。