> ## Content Index
> Fetch the complete content index at: https://tbbbk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenClaw 重装不求人：彻底卸载 + 全新安装完整教程（2026）
- URL: https://tbbbk.com/openclaw-reinstall-clean-guide/
- Published: 2026-03-03T17:21:46.000Z
- Updated: 2026-03-03T17:21:46.000Z
- Description: 配置改乱了、版本升级出问题、想从头来——这篇把 OpenClaw 彻底卸载和全新安装的完整流程写清楚。一键卸载命令、手动清理步骤、重装后的 doctor 检查，以及常见卡点逐一说明。
- Author: TuBaiBai
- Tags: 折腾日记, #Import 2026-07-20 07:13

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

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

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

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

## 第一步：彻底卸载

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

```
openclaw uninstall
```

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

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

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

![OpenClaw 重装卸载教程：官方文档中的 openclaw uninstall 命令完整说明](https://tbbbk.com/content/images/2026/03/openclaw-uninstall-docs-v2.jpg)

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

有时候版本比较旧，或者 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 安装报错完全解决手册](https://tbbbk.com/openclaw-install-error-fix-2026/)，覆盖了大部分常见错误，可以先对照查一查。

如果是第一次装，想看完整的安装过程，可以看 [这篇从头记录的安装全过程](https://tbbbk.com/openclaw-install-host-vs-docker-debian-ubuntu/)（宿主机 vs Docker 对比 + 完整命令行输出）。

装完想知道能用哪些命令，可以参考 [OpenClaw CLI 命令完全指南](https://tbbbk.com/openclaw-cli-commands-guide/)。