OpenClaw 完全卸载保姆级教程(Windows/macOS/Linux)

MCP专区6小时前发布 小悠
7 0 0

作为一个经历过多次“养虾”又“弃养”,我深知OpenClaw这只“龙虾”在系统里扎根有多深。很多人以为npm uninstall就完事了,结果发现Gateway服务还在后台运行,API密钥还躺在配置文件里,甚至历史版本的残留目录也占着磁盘空间。

本文将手把手带你安全、彻底、优雅地卸载OpenClaw,覆盖三大主流操作系统。


📦 第0步:备份——给自己留条后路(可选但推荐)

在动刀之前,如果你将来可能还想“复养”,建议先备份配置和工作区:

bash
# 备份整个配置目录(包含API密钥、记忆、技能)
cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)

# 如果你只关心工作区文件
cp -r ~/.openclaw/workspace ~/openclaw-workspace-backup

⚠️ 注意:备份文件包含敏感信息(API Key、OAuth令牌),请妥善保管。


🪟 Windows系统卸载

1️⃣ 停止后台服务(计划任务)

OpenClaw在Windows上以计划任务形式自启,必须先停掉。

以管理员身份打开 PowerShell,执行:

powershell
# 删除计划任务
schtasks /Delete /F /TN "OpenClaw Gateway"

# 如果你使用了配置文件(--profile),任务名可能是 "OpenClaw Gateway (profile名)"
# schtasks /Delete /F /TN "OpenClaw Gateway (myprofile)"

# 终止所有相关进程
Get-Process -Name "openclaw*" -ErrorAction SilentlyContinue | Stop-Process -Force

验证服务是否停止(检查端口18789):

powershell
netstat -ano | findstr :18789
# 若无输出,说明服务已停止

2️⃣ 执行卸载

✅ 方法A:使用官方卸载命令(CLI仍在)

如果openclaw命令还能用,这是最干净的方式:

powershell
# 停止并卸载网关服务 + 删除状态目录
openclaw uninstall --all --yes --non-interactive

✅ 方法B:手动卸载(CLI已丢失)

powershell
# 1. 卸载npm全局包
npm uninstall -g openclaw
# 若使用pnpm/bun
pnpm remove -g openclaw
bun remove -g openclaw

# 2. 删除计划任务脚本(上一步已删,但确认一下)
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue

3️⃣ 清理残留文件

OpenClaw的配置目录和改名前的历史残留都必须清理:

powershell
# 当前版本配置
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue

# 历史版本残留(Clawdbot / Moltbot 时代)
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.moltbot" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.molthub" -ErrorAction SilentlyContinue

# AppData 位置
Remove-Item -Recurse -Force "$env:APPDATA\OpenClaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\OpenClaw" -ErrorAction SilentlyContinue

4️⃣ (可选)清理注册表

如果你对系统洁癖较重,可使用CCleaner等工具扫描无效的OpenClaw注册表项。


🍎 macOS系统卸载

1️⃣ 停止后台服务(LaunchAgent)

macOS下OpenClaw通过LaunchAgent实现用户级自启。

bash
# 停止并卸载当前版本的服务(标签可能不同,全执行一遍确保干净)
launchctl bootout gui/$UID/bot.molt.gateway 2>/dev/null
launchctl bootout gui/$UID/com.openclaw.gateway 2>/dev/null
launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/null

# 删除plist文件
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist
rm -f ~/Library/LaunchAgents/com.openclaw.gateway.plist
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

# 杀死残留进程
pkill -f openclaw || true

验证:

bash
launchctl list | grep -i "claw\|molt\|gateway"
lsof -i :18789  # 检查端口

2️⃣ 执行卸载

✅ 方法A:官方命令(CLI仍在)

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

✅ 方法B:Homebrew安装

如果通过brew install openclaw安装:

bash
brew uninstall openclaw
brew autoremove  # 清理无用的依赖

✅ 方法C:手动卸载(CLI已丢失)

bash
# 1. 卸载npm包
npm uninstall -g openclaw

# 2. 删除应用(如果装了桌面版)
rm -rf /Applications/OpenClaw.app

3️⃣ 清理残留文件

bash
# 当前配置
rm -rf ~/.openclaw

# 历史版本残留
rm -rf ~/.clawdbot
rm -rf ~/.moltbot
rm -rf ~/.molthub

# 临时目录
rm -rf /tmp/openclaw/

4️⃣ 清理Shell配置

检查~/.bashrc~/.zshrc~/.bash_profile,删除与OpenClaw相关的环境变量(如OPENCLAW_CONFIG_PATH、PATH添加等)。


🐧 Linux系统卸载(以Ubuntu为例)

1️⃣ 停止后台服务(systemd用户单元)

bash
# 停止并禁用服务
systemctl --user stop openclaw-gateway.service
systemctl --user disable openclaw-gateway.service

# 删除服务单元文件
rm -f ~/.config/systemd/user/openclaw-gateway.service

# 重载systemd
systemctl --user daemon-reload

# 如果使用PM2
pm2 delete openclaw
pm2 save

验证:

bash
ps aux | grep -i "openclaw\|clawdbot"
lsof -i :18789

2️⃣ 执行卸载

✅ 方法A:官方命令(CLI仍在)

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

✅ 方法B:桌面版(deb包)

bash
# 强制关闭进程
killall OpenClaw || pkill OpenClaw

# 卸载deb包
sudo dpkg -r openclaw

# 如果是snap安装
sudo snap remove openclaw

✅ 方法C:npm安装

bash
npm uninstall -g openclaw

3️⃣ 清理残留文件

bash
# 状态目录
rm -rf ~/.openclaw

# 历史残留
rm -rf ~/.clawdbot
rm -rf ~/.moltbot
rm -rf ~/.molthub

# 配置缓存(若有)
rm -rf ~/.config/OpenClaw

4️⃣ 清理Docker部署(如果使用)

bash
cd ~/openclaw  # 进入你的docker-compose目录
docker compose down --volumes --remove-orphans
docker rmi openclaw/openclaw:latest 2>/dev/null

# 暴力清理所有相关容器
docker ps -a --filter "name=openclaw" --format "{{.ID}}" | xargs -r docker rm -f
docker volume prune -f

🧹 卸载后常见问题与解决方案

❓ 问题1:服务仍在运行(端口18789还在监听)

现象:卸载后访问http://localhost:18789还能打开界面,或lsof -i :18789有输出。

原因:服务未正确停止,或卸载顺序颠倒(先删了CLI没删服务)。

解决方案

  • Windows:重新以管理员运行PowerShell,schtasks /Delete /F /TN "OpenClaw Gateway",然后taskkill /F /IM node.exe(谨慎,会杀死所有Node进程)。

  • macOS/Linux:找到进程并强制杀死:

    bash
    kill -9 $(lsof -ti :18789)

    然后删除对应的服务配置文件(launchd/systemd)。

❓ 问题2:命令openclaw仍可运行

现象:卸载后输入openclaw依然有输出。

原因:可能通过多种方式安装(如npm + 源码共存),或PATH中仍有残留。

解决方案

bash
which openclaw  # 找到位置
rm -rf $(which openclaw)  # 直接删除二进制

同时检查npm root -g目录,手动删除openclaw文件夹。

❓ 问题3:API密钥未撤销(最危险!)

现象:虽然软件卸载了,但之前授权的Google、GitHub等账号依然允许“OpenClaw应用”访问。

原因:OAuth授权存储在服务端,本地删除不影响。

解决方案:手动访问各平台撤销授权——

平台 撤销路径
Google myaccount.google.com/permissions
GitHub Settings → Applications → Authorized OAuth Apps
Slack slack.com/apps/manage
Microsoft account.live.com/consent/Manage

同时,建议重新生成所有曾配置在OpenClaw中的API Key(OpenAI、DeepSeek、阿里云等)。

❓ 问题4:磁盘空间未释放

现象:卸载后C盘/根目录空间没变化。

原因:Docker镜像、npm缓存、历史残留目录未被清理。

解决方案

bash
# 查看npm缓存并清理
npm cache clean --force

# Docker清理
docker system prune -a --volumes

# 手动搜索残留
find ~ -name "*openclaw*" -o -name "*clawdbot*" -o -name "*moltbot*" 2>/dev/null

❓ 问题5:卸载过程中报错“权限不足”

原因:OpenClaw的部分文件(如systemd服务、计划任务)需要管理员/root权限。

解决方案

  • Windows:务必以管理员身份运行PowerShell/cmd。

  • macOS/Linux:某些操作可能需要sudo,但优先使用--user级别的命令。如果必须用sudo,请确保你知道在做什么。

❓ 问题6:配置文件使用了--profile或自定义路径

现象:删了~/.openclaw,但配置还在。

原因:OpenClaw支持多配置文件,状态目录可能在~/.openclaw-<profile>或自定义的OPENCLAW_CONFIG_PATH

解决方案

  • 检查环境变量:echo $OPENCLAW_CONFIG_PATH

  • 搜索所有以.openclaw开头的目录:ls -d ~/.openclaw*

  • 逐个删除


✅ 最终验证清单

执行完以上步骤后,用以下命令确认卸载彻底:

Windows

powershell
# 命令不存在
Get-Command openclaw -ErrorAction SilentlyContinue

# 目录不存在
Test-Path "$env:USERPROFILE\.openclaw"

# 计划任务不存在
schtasks /Query /TN "OpenClaw Gateway" 2>$null

macOS/Linux

bash
# 命令不存在
which openclaw

# 目录不存在
ls -d ~/.openclaw ~/.clawdbot ~/.moltbot 2>/dev/null

# 服务不存在
launchctl list | grep -i claw  # macOS
systemctl --user list-units | grep -i claw  # Linux

📌 写在最后

OpenClaw是一款极具潜力的AI智能体,但目前仍处于极早期阶段,默认配置存在安全风险,且卸载流程比普通软件复杂。如果你经过评估决定“弃养”,请务必按照本教程逐项操作,特别是撤销OAuth授权轮换API密钥这两步,直接关系到你的数字资产安全。

如果卸载过程中遇到本文未覆盖的问题,欢迎随时提问。祝你卸载顺利,数字生活清爽干净!

OpenClaw 完全卸载保姆级教程(Windows/macOS/Linux)

关注 “悠AI” 更多干货技巧行业动态

© 版权声明

相关文章

没有相关内容!

暂无评论

您必须登录才能参与评论!
立即登录
none
暂无评论...