场景 1：我只是想升级到最新版

最稳的升级顺序是：更新 -> doctor 检查 -> 重启 -> 验证。

最推荐：重新运行官网安装脚本

curl -fsSL https://openclaw.ai/install.sh | bash

如果你不想再次进入 onboarding，可以用：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

如果你当初就是 npm / pnpm 全局安装

npm i -g openclaw@latest
pnpm add -g openclaw@latest

如果你走的是源码 / git 路线

openclaw update

升级后一定要做的检查

openclaw doctor
openclaw gateway restart
openclaw health

很多“升级后突然不对劲”的问题，其实不是版本坏了，而是没跑 openclaw doctor。

场景 2：我想重置一下，但不想整套删掉

如果你的问题是配置乱了、认证状态坏了、某些本地状态异常，但 CLI 本身还正常，优先试：

openclaw reset

更细一点可以指定 scope：

openclaw reset --scope config+creds+sessions --yes --non-interactive

这条路的好处是：重置本地状态，但保留安装本身。它通常比“删干净再装一遍”更省事。

场景 3：我想完整重装，或者切换安装方式

完整重装更像一个流程，而不是单独一条命令。最稳的顺序是：

1. 先备份：openclaw backup create --verify
2. 卸掉服务和本地状态：openclaw uninstall
3. 如果还想把全局 CLI 一起删掉，再按安装方式移除包
4. 重新用你新的目标安装方式安装
5. 最后跑：openclaw doctor

如果你是从 npm 路线切到 git 路线，或者从脚本路线切到别的方式，完成后一定要再跑一次 doctor，让 Gateway 服务入口重新对齐当前安装方式。

场景 4：我想彻底卸载

官方卸载文档把它分成“CLI 还在”和“CLI 没了但服务还在”两条路。对大多数用户来说，先走最简单的内置卸载就够了：

openclaw uninstall

如果你需要脚本化：

openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive

这里要特别注意：默认更偏向卸掉 Gateway 服务和本地数据，CLI 本身可能还会保留。如果你还想把全局 CLI 一起删掉，再按安装方式补一步：

npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw

如果 CLI 都没了，但服务还留着怎么办

这时候要按系统手动清服务：

macOS（launchd）

launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Linux（systemd user）

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

Windows（Scheduled Task）

schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"