OpenClaw 重装不求人：彻底卸载 + 全新安装完整教程（2026）

有些问题，重启解决不了，得重装。

OpenClaw 安装目录散得比较开——CLI 是全局 npm 包，配置和数据在 ~/.openclaw/，Gateway 是 systemd 服务，各有各的地方。如果你只是 npm rm -g openclaw 了事，服务还在跑，数据还在磁盘，下次装新版说不定就出各种奇怪的冲突。

这篇把「彻底卸载 + 全新安装」的完整流程写清楚，适合以下几种情况：

• 配置改乱了，想从头来
• 版本升级出问题，想干净重装
• 换了 VPS，老机器想彻底清掉
• 就是想重来一次

第一步：彻底卸载

OpenClaw 官方提供了一键卸载命令，推荐先用这个：

openclaw uninstall

它会交互式地问你要不要保留数据、要不要删工作区。如果你确定要全删干净，直接用非交互式版本：

openclaw uninstall --all --yes --non-interactive

这条命令会把 Gateway 服务停掉并卸载、删 ~/.openclaw/ 状态目录、移除 CLI 全局包，一步到位。

如果一键命令跑不了，手动卸载

有时候版本比较旧，或者 CLI 本身已经出问题了，openclaw uninstall 执行不了。这时候手动来：

1. 停止并卸载 Gateway 服务

openclaw gateway stop
openclaw gateway uninstall

如果 openclaw 命令都跑不了，直接用 systemd 操作（Linux）：

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

2. 删除状态目录和配置

rm -rf ~/.openclaw

⚠️ 这一步会连工作区（~/.openclaw/workspace/）一起删掉。如果里面有你要保留的文件，先备份：

cp -r ~/.openclaw/workspace ~/openclaw-workspace-backup

3. 卸载 CLI

# npm 安装的
npm rm -g openclaw

# pnpm 安装的
pnpm remove -g openclaw

4. 确认清干净了

which openclaw
ls ~/.openclaw

两条命令都没有输出，就说明卸载干净了。

第二步：重新安装

卸载完，等个几秒，然后重装。官方安装命令（在终端直接运行）：

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

这条命令会装 CLI 并自动启动新手引导（onboard）。如果你只想装 CLI、跳过引导：

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

手动引导（之后随时可以跑）：

openclaw onboard --install-daemon

装完先跑 doctor

openclaw doctor

这条命令会检查环境依赖、Gateway 状态、配置有没有问题。有红色报错就按提示修，黄色警告可以先忽略。

常见卡点

Node 版本不够（需要 >= 22）

node -v

不够的话用 nvm 升级：

nvm install 22 && nvm use 22

或者 Debian/Ubuntu 直接走包管理：先从 nodesource 拉 setup 脚本，再 apt install nodejs。

安装时报 sharp 相关错误

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Gateway 服务没启动

systemctl --user status openclaw-gateway
openclaw gateway start

重装后需要重新配置渠道

全新重装后，之前的 Telegram bot token、模型配置全都清空了，需要重新设置。进 TUI 重新配：

openclaw tui

什么情况不需要重装

重装是最后手段，很多问题其实不用这么彻底。遇到问题先试试这几个：

• Gateway 没响应 → openclaw gateway restart
• 配置改坏了 → ~/.openclaw/openclaw.json 有 .bak 备份，恢复一下
• 版本落后 → npm install -g openclaw@latest 直接升，不用卸载
• 报错看不懂 → openclaw doctor 先跑一遍，通常能定位问题

关于安装时各种报错，我之前整理过一篇 OpenClaw 安装报错完全解决手册，覆盖了大部分常见错误，可以先对照查一查。

如果是第一次装，想看完整的安装过程，可以看 这篇从头记录的安装全过程（宿主机 vs Docker 对比 + 完整命令行输出）。

装完想知道能用哪些命令，可以参考 OpenClaw CLI 命令完全指南。