作为一个经历过多次“养虾”又“弃养”,我深知OpenClaw这只“龙虾”在系统里扎根有多深。很多人以为npm uninstall就完事了,结果发现Gateway服务还在后台运行,API密钥还躺在配置文件里,甚至历史版本的残留目录也占着磁盘空间。
本文将手把手带你安全、彻底、优雅地卸载OpenClaw,覆盖三大主流操作系统。
📦 第0步:备份——给自己留条后路(可选但推荐)
在动刀之前,如果你将来可能还想“复养”,建议先备份配置和工作区:
# 备份整个配置目录(包含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,执行:
# 删除计划任务 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):
netstat -ano | findstr :18789 # 若无输出,说明服务已停止
2️⃣ 执行卸载
✅ 方法A:使用官方卸载命令(CLI仍在)
如果openclaw命令还能用,这是最干净的方式:
# 停止并卸载网关服务 + 删除状态目录 openclaw uninstall --all --yes --non-interactive
✅ 方法B:手动卸载(CLI已丢失)
# 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的配置目录和改名前的历史残留都必须清理:
# 当前版本配置 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实现用户级自启。
# 停止并卸载当前版本的服务(标签可能不同,全执行一遍确保干净) 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
验证:
launchctl list | grep -i "claw\|molt\|gateway" lsof -i :18789 # 检查端口
2️⃣ 执行卸载
✅ 方法A:官方命令(CLI仍在)
openclaw uninstall --all --yes --non-interactive
✅ 方法B:Homebrew安装
如果通过brew install openclaw安装:
brew uninstall openclaw
brew autoremove # 清理无用的依赖
✅ 方法C:手动卸载(CLI已丢失)
# 1. 卸载npm包 npm uninstall -g openclaw # 2. 删除应用(如果装了桌面版) rm -rf /Applications/OpenClaw.app
3️⃣ 清理残留文件
# 当前配置 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用户单元)
# 停止并禁用服务 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
验证:
ps aux | grep -i "openclaw\|clawdbot" lsof -i :18789
2️⃣ 执行卸载
✅ 方法A:官方命令(CLI仍在)
openclaw uninstall --all --yes --non-interactive
✅ 方法B:桌面版(deb包)
# 强制关闭进程 killall OpenClaw || pkill OpenClaw # 卸载deb包 sudo dpkg -r openclaw # 如果是snap安装 sudo snap remove openclaw
✅ 方法C:npm安装
npm uninstall -g openclaw
3️⃣ 清理残留文件
# 状态目录 rm -rf ~/.openclaw # 历史残留 rm -rf ~/.clawdbot rm -rf ~/.moltbot rm -rf ~/.molthub # 配置缓存(若有) rm -rf ~/.config/OpenClaw
4️⃣ 清理Docker部署(如果使用)
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:找到进程并强制杀死:
kill -9 $(lsof -ti :18789)
然后删除对应的服务配置文件(launchd/systemd)。
❓ 问题2:命令openclaw仍可运行
现象:卸载后输入openclaw依然有输出。
原因:可能通过多种方式安装(如npm + 源码共存),或PATH中仍有残留。
解决方案:
which openclaw # 找到位置 rm -rf $(which openclaw) # 直接删除二进制
同时检查npm root -g目录,手动删除openclaw文件夹。
❓ 问题3:API密钥未撤销(最危险!)
现象:虽然软件卸载了,但之前授权的Google、GitHub等账号依然允许“OpenClaw应用”访问。
原因:OAuth授权存储在服务端,本地删除不影响。
解决方案:手动访问各平台撤销授权——
| 平台 | 撤销路径 |
|---|---|
| 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缓存、历史残留目录未被清理。
解决方案:
# 查看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
# 命令不存在 Get-Command openclaw -ErrorAction SilentlyContinue # 目录不存在 Test-Path "$env:USERPROFILE\.openclaw" # 计划任务不存在 schtasks /Query /TN "OpenClaw Gateway" 2>$null
macOS/Linux
# 命令不存在 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密钥这两步,直接关系到你的数字资产安全。
如果卸载过程中遇到本文未覆盖的问题,欢迎随时提问。祝你卸载顺利,数字生活清爽干净!

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