有些问题，重启解决不了，得重装。
OpenClaw 安装目录散得比较开——CLI 是全局 npm 包，配置和数据在 ，Gateway 是 systemd 服务，各有各的地方。如果你只是 了事，服务还在跑，数据还在磁盘，下次装新版说不定就出各种奇怪的冲突。
这篇把「彻底卸载 + 全新安装」的完整流程写清楚，适合以下几种情况：
- 配置改乱了，想从头来
- 版本升级出问题，想干净重装
- 换了 VPS，老机器想彻底清掉
- 就是想重来一次
OpenClaw 官方提供了一键卸载命令，推荐先用这个：
它会交互式地问你要不要保留数据、要不要删工作区。如果你确定要全删干净，直接用非交互式版本：
这条命令会把 Gateway 服务停掉并卸载、删 状态目录、移除 CLI 全局包，一步到位。
有时候版本比较旧，或者 CLI 本身已经出问题了， 执行不了。这时候手动来：
1. 停止并卸载 Gateway openclaw 服务
如果 openclaw 命令都跑不了，直接用 systemd 操作（Linux）：
2. 删除状态目录和配置
⚠️ 这一步会连工作区（）一起删掉。如果里面有你要保留的文件，先备份：
3. 卸载 CLI
4. 确认清干净了
两条命令都没有输出，就说明卸载干净了。
卸载完，等个几秒，然后重装。官方安装命令（在终端直接运行）：
这条命令会装 CLI 并自动启动新手引导（onboard）。如果你只想装 CLI、跳过引导：
手动引导（之后随时可以跑）：
这条命令会检查环境依赖、Gateway 状态、配置有没有问题。有红色报错就按提示修，黄色警告可以先忽略。
不够的话用 nvm 升级：
或者 Debian/Ubuntu 直接走包管理：先从 nodesource 拉 setup 脚本，再 apt install nodejs。
全新重装后，之前的 Telegram bot token、模型配置全都清空了，需要重新设置。进 TUI 重新配：
重装是最后手段，很多问题其实不用这么彻底。遇到问题先试试这几个：
- Gateway 没响应 →
- 配置改坏了 → 有 .bak 备份，恢复一下
- 版本落后 → 直接升，不用卸载
- 报错看不懂 → 先跑一遍，通常能定位问题
关于安装时各种报错，我之前整理过一篇 OpenClaw 安装报错完全解决手册，覆盖了大部分常见错误，可以先对照查一查。
如果是第一次装，想看完整的安装过程，可以看 这篇从头记录的安装全过程（宿主机 vs Docker 对比 + 完整命令行输出）。
装完想知道能用哪些命令，可以参考 OpenClaw CLI 命令完全指南。
发布者：Ai探索者，转载请注明出处：https://javaforall.net/252538.html原文链接：https://javaforall.net
