【AI分享】OpenClaw 重装:彻底卸载 + 全新安装完整教程

openClaw升级到3.28的版本了，由于之前安装的版本太久，所以今天研究了下重新安openClaw，也顺便把 OpenClaw 彻底卸载和全新安装的完整流程分享给大家：一键卸载命令、手动清理步骤、重装后的 doctor 检查，以及常见卡点逐一说明，照着做就可以了。

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

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

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

第一步：彻底卸载

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

openclaw uninstall

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

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

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

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

1. 停止并卸载 Gateway 服务

openclaw gateway stopopenclaw gateway uninstall

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

systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --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 openclawls ~/.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

openclaw doctor

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

node -v

不够的话用 nvm 升级：

nvm install 22 && nvm use 22

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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

systemctl --user status openclaw-gatewayopenclaw gateway start

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

openclaw tui

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

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

如果是第一次装，想看完整的安装过程，可以看这篇从头记录的安装全过程【AI分享】Windows 使用 OpenClaw！最完整安装教程。

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