📌 目录
-
快速导航
-
Windows 平台卸载
-
准备工作
-
方式一:通过 npm/pnpm/bun/yarn 安装
-
方式二:通过官方安装脚本安装
-
方式三:通过独立安装包(.exe/.msi)安装
-
方式四:手动清理残留(万能方法)
-
-
WSL2 平台卸载
-
准备工作
-
方式一:CLI 命令可用
-
方式二:手动清理残留(CLI 不可用时)
-
Windows 层面清理 WSL2
-
特殊情况:Docker 安装
-
-
验证卸载是否成功
-
Windows 验证
-
WSL2 验证
-
-
常见问题
🚀 快速导航
| 你的环境 | 直接跳转 |
|---|---|
| Windows(CMD / PowerShell) | Windows 平台卸载 |
| WSL2(Ubuntu/Debian 等 Linux 子系统) | WSL2 平台卸载 |
🪟 Windows 平台卸载
Windows 准备工作
以管理员身份 打开 PowerShell,执行以下命令确认状态:
powershell
# 检查 openclaw 命令是否存在
where.exe openclaw
openclaw --version
# 检查计划任务
schtasks /Query | findstr /i "openclaw"
schtasks /Query | findstr /i "clawdbot"
-
如果
openclaw命令可用 → 优先使用 方式一 或 方式二 -
如果命令不可用 → 直接使用 方式四 手动清理
Windows 方式一:通过 npm/pnpm/bun/yarn 安装
第 1 步:停止并移除计划任务
powershell
# 停止计划任务
schtasks /End /TN "OpenClaw Gateway" 2>$null
# 删除计划任务
schtasks /Delete /F /TN "OpenClaw Gateway" 2>$null
schtasks /Delete /F /TN "clawdbot-gateway" 2>$null
第 2 步:卸载 CLI 命令
| 包管理器 | 卸载命令 |
|---|---|
| npm | npm uninstall -g openclaw |
| pnpm | pnpm remove -g openclaw |
| bun | bun remove -g openclaw |
| yarn | yarn global remove openclaw |
第 3 步:删除配置文件
powershell
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot" -ErrorAction SilentlyContinue
Windows 方式二:通过官方安装脚本安装
第 1 步:使用内置卸载命令
powershell
# 如果 openclaw 命令还在
openclaw uninstall --all --yes
第 2 步:停止并删除计划任务
powershell
schtasks /End /TN "OpenClaw Gateway" 2>$null
schtasks /Delete /F /TN "OpenClaw Gateway" 2>$null
schtasks /Delete /F /TN "clawdbot-gateway" 2>$null
第 3 步:清理文件
powershell
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\AppData\Roaming\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\AppData\Local\openclaw" -ErrorAction SilentlyContinue
Windows 方式三:通过独立安装包(.exe/.msi)安装
第 1 步:通过 Windows 设置卸载
-
按
Win + I打开 设置 -
进入 应用 → 已安装的应用
-
搜索
OpenClaw -
点击 卸载 并按提示完成
第 2 步:手动清理残留
powershell
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:ProgramData\OpenClaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Programs\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\OpenClaw" -ErrorAction SilentlyContinue
Windows 方式四:手动清理残留(万能方法)
当 openclaw 命令已无法使用时,手动清理以下内容:
第 1 步:清理计划任务
powershell
# 查找并删除所有相关计划任务
schtasks /Query | findstr /i "openclaw"
schtasks /Query | findstr /i "clawdbot"
# 删除找到的任务(将 TaskName 替换为实际名称)
schtasks /Delete /F /TN "OpenClaw Gateway"
schtasks /Delete /F /TN "clawdbot-gateway"
第 2 步:清理所有配置目录
powershell
# 一键清理所有可能的目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\AppData\Roaming\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\AppData\Roaming\clawdbot" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\AppData\Local\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\AppData\Local\clawdbot" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:ProgramData\OpenClaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:ProgramData\clawdbot" -ErrorAction SilentlyContinue
第 3 步:清理 npm 全局残留(如适用)
powershell
# 查看 npm 全局包位置
npm root -g
# 手动删除(路径根据上一步结果调整)
Remove-Item -Recurse -Force "C:\Users\$env:USERNAME\AppData\Roaming\npm\node_modules\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Force "C:\Users\$env:USERNAME\AppData\Roaming\npm\openclaw.cmd" -ErrorAction SilentlyContinue
Remove-Item -Force "C:\Users\$env:USERNAME\AppData\Roaming\npm\openclaw.ps1" -ErrorAction SilentlyContinue
第 4 步:清理环境变量 PATH
-
按
Win + R,输入sysdm.cpl -
点击 高级 → 环境变量
-
在 用户变量 和 系统变量 中找到
Path,删除包含openclaw的路径
🐧 WSL2 平台卸载
WSL2 准备工作
在 WSL2 终端中执行:
bash
# 确认发行版类型
cat /etc/os-release
# 检查 openclaw 状态
which openclaw
openclaw --version
# 检查 systemd 服务(Ubuntu 22.04+)
systemctl --user list-units | grep -i openclaw
systemctl list-units | grep -i openclaw
WSL2 方式一:CLI 命令可用
第 1 步:运行官方卸载命令
bash
openclaw uninstall --all --yes
第 2 步:停止并移除 systemd 服务
bash
# 停止用户服务
systemctl --user stop openclaw-gateway 2>/dev/null
systemctl --user stop clawdbot-gateway 2>/dev/null
# 禁用服务
systemctl --user disable openclaw-gateway 2>/dev/null
systemctl --user disable clawdbot-gateway 2>/dev/null
# 删除服务文件
rm -f ~/.config/systemd/user/openclaw-gateway.service
rm -f ~/.config/systemd/user/clawdbot-gateway.service
# 重载 systemd
systemctl --user daemon-reload
第 3 步:删除配置和缓存
bash
rm -rf ~/.openclaw
rm -rf ~/.clawdbot
rm -rf ~/.cache/openclaw
rm -rf ~/.local/share/openclaw
第 4 步:卸载 CLI 命令
| 安装方式 | 卸载命令 |
|---|---|
| npm | npm uninstall -g openclaw |
| pnpm | pnpm remove -g openclaw |
| bun | bun remove -g openclaw |
| yarn | yarn global remove openclaw |
| pip | pip uninstall openclaw |
| 源码安装 | 删除安装目录(如 /opt/openclaw) |
第 5 步:清理 npm 全局目录(如适用)
bash
# 查看并删除残留
npm root -g
rm -rf /usr/local/lib/node_modules/openclaw
rm -f /usr/local/bin/openclaw
WSL2 方式二:手动清理残留(CLI 不可用时)
第 1 步:终止相关进程
bash
# 查找并终止进程
ps aux | grep -i openclaw
ps aux | grep -i clawdbot
pkill -f openclaw
pkill -f clawdbot
第 2 步:清理 systemd 服务
bash
# 查找并删除服务文件
find ~/.config/systemd -name "*openclaw*" -delete 2>/dev/null
find /etc/systemd -name "*openclaw*" -delete 2>/dev/null
# 重载 systemd
systemctl --user daemon-reload
sudo systemctl daemon-reload
第 3 步:删除所有配置文件
bash
# 全面清理
rm -rf ~/.openclaw
rm -rf ~/.clawdbot
rm -rf ~/.config/openclaw
rm -rf ~/.local/share/openclaw
rm -rf ~/.cache/openclaw
rm -rf ~/.npm/openclaw
rm -rf /tmp/openclaw*
第 4 步:清理 shell 配置文件
bash
# 检查并编辑配置文件
grep -i openclaw ~/.bashrc ~/.zshrc ~/.profile 2>/dev/null
# 手动删除相关行
nano ~/.bashrc # 或 ~/.zshrc
第 5 步:清理包管理器安装的版本
bash
# Ubuntu/Debian
sudo apt remove --purge openclaw
sudo apt autoremove
# Arch
sudo pacman -Rns openclaw
# Snap
sudo snap remove openclaw
Windows 层面清理 WSL2
方法 1:删除整个 WSL2 发行版(最彻底)
powershell
# 在 Windows PowerShell(管理员)中执行
# 查看已安装的发行版
wsl -l -v
# 终止目标发行版
wsl -t <发行版名称>
# 导出备份(可选)
wsl --export <发行版名称> D:\backup\<发行版名称>.tar
# 注销并删除发行版
wsl --unregister <发行版名称>
方法 2:保留发行版,只清理文件
bash
# 在 WSL2 终端中执行
cd /
sudo find / -name "*openclaw*" -type f 2>/dev/null | grep -v "/proc/" | grep -v "/sys/"
sudo find / -name "*openclaw*" -type f -delete 2>/dev/null
sudo find / -name "*clawdbot*" -type f -delete 2>/dev/null
特殊情况:Docker 安装
如果在 WSL2 中通过 Docker 运行 OpenClaw:
bash
# 停止并删除容器
docker stop $(docker ps -a | grep openclaw | awk '{print $1}') 2>/dev/null
docker rm $(docker ps -a | grep openclaw | awk '{print $1}') 2>/dev/null
# 删除镜像
docker rmi $(docker images | grep openclaw | awk '{print $3}') 2>/dev/null
# 删除卷
docker volume rm $(docker volume ls | grep openclaw | awk '{print $2}') 2>/dev/null
✅ 验证卸载是否成功
Windows 验证
以管理员身份打开 PowerShell,执行以下检查:
| 检查项 | 命令 | 预期结果 |
|---|---|---|
| CLI 命令 | openclaw --version |
命令未找到 |
| 详细路径 | where.exe openclaw |
无输出 |
| 配置目录 | Test-Path "$env:USERPROFILE\.openclaw" |
False |
| 计划任务 | `schtasks /Query | findstr /i "openclaw"` |
| npm 全局包 | `npm list -g --depth=0 | findstr openclaw` |
powershell
# 一键验证脚本
Write-Host "=== OpenClaw 卸载验证 ===" -ForegroundColor Cyan
Write-Host "1. 检查 CLI 命令: " -NoNewline
if (Get-Command openclaw -ErrorAction SilentlyContinue) { Write-Host "❌ 仍存在" -ForegroundColor Red } else { Write-Host "✅ 已清除" -ForegroundColor Green }
Write-Host "2. 检查配置目录: " -NoNewline
if (Test-Path "$env:USERPROFILE\.openclaw") { Write-Host "❌ 仍存在" -ForegroundColor Red } else { Write-Host "✅ 已清除" -ForegroundColor Green }
Write-Host "3. 检查计划任务: " -NoNewline
if (schtasks /Query 2>$null | findstr /i "openclaw") { Write-Host "❌ 仍存在" -ForegroundColor Red } else { Write-Host "✅ 已清除" -ForegroundColor Green }
WSL2 验证
在 WSL2 终端中执行:
| 检查项 | 命令 | 预期结果 |
|---|---|---|
| CLI 命令 | which openclaw |
无输出 |
| 配置文件 | ls ~/.openclaw |
No such file |
| systemd 服务 | `systemctl --user list-units | grep openclaw` |
| 运行进程 | `ps aux | grep openclaw |
| npm 全局包 | `npm list -g --depth=0 | grep openclaw` |
bash
# 一键验证脚本
#!/bin/bash
echo "=== OpenClaw 卸载验证 ==="
echo -n "1. 检查 CLI 命令: "
if command -v openclaw &> /dev/null; then echo "❌ 仍存在"; else echo "✅ 已清除"; fi
echo -n "2. 检查配置目录: "
if [ -d ~/.openclaw ]; then echo "❌ 仍存在"; else echo "✅ 已清除"; fi
echo -n "3. 检查 systemd 服务: "
if systemctl --user list-units 2>/dev/null | grep -qi openclaw; then echo "❌ 仍存在"; else echo "✅ 已清除"; fi
echo -n "4. 检查运行进程: "
if pgrep -f openclaw &> /dev/null; then echo "❌ 仍存在"; else echo "✅ 已清除"; fi
❓ 常见问题
Q: 卸载后想重装,但一直报错怎么办?
A: 配置文件没删干净。重点检查:
-
Windows:
%USERPROFILE%\.openclaw目录 -
WSL2:
~/.openclaw和~/.config/systemd/user/中的服务文件手动删除后再重装。
Q: 提示 "权限不足" 无法删除文件?
A:
-
Windows:以管理员身份打开 PowerShell
-
WSL2:使用
sudo执行删除命令 -
如果还不行,重启电脑/WSL2 后再试
Q: 卸载后系统启动变慢(Windows)?
A: 检查是否还有残留的计划任务。打开 taskschd.msc(任务计划程序),手动删除任何与 openclaw 相关的任务。
Q: WSL2 中提示 "Failed to connect to bus"?
A: 这是 systemd 未启动导致的。可以:
-
使用
service命令替代:service --status-all | grep openclaw -
或者直接检查进程:
ps aux | grep openclaw
Q: 如何确认 WSL2 发行版名称?
A: 在 Windows PowerShell 中执行 wsl -l -v
Q: 最彻底的清理方案是什么?
A:
-
Windows:按方式四手动清理所有目录 + 删除计划任务 + 清理 PATH
-
WSL2 :备份数据后,在 Windows 中执行
wsl --unregister <发行版名称>删除整个发行版
如果以上所有检查项都通过,恭喜你,OpenClaw 已经完全卸载干净了!