OpenClaw 通用卸载指南
—— 当所有人都在教安装,我来教你怎么删干净
最近最火的 AI 项目之一,大概就是 OpenClaw 了。
两个月 GitHub 30 万 Star,深圳“龙虾十条”一出,直接掀起全国养虾热。
网上的教程基本都是:
如何安装 如何部署 如何养虾
但很少有人认真讲一件事:
如果你想卸载,怎么才能删干净?
今天这篇就专门聊这个。
😫 为什么你删不干净 OpenClaw?
很多人遇到过这些情况:
❌ 文件夹删了,但 openclaw命令还能用❌ 卸载后 18789 端口 还被占用 ❌ Gateway 服务还在后台跑 ❌ 重装后配置混乱,新老版本冲突
核心原因:OpenClaw 并不是一个单一程序, 它的组件分散在系统多个位置:
openclaw | ||
~/.openclaw/ | ||
~/.openclaw/workspace/ |
所以:
只删文件夹,远远不够。
想卸载干净,需要做一整套清理
下面一步一步来👇
卸载前先做一件事:备份数据
🚨危险
除非你清楚自己在做什么,否则卸载前备份
⚠️ 如果你已经在 OpenClaw 里配置了技能、聊天平台或者存储了工作区数据,
建议先备份
因为卸载可能会直接删除这些内容
备份工作区
mkdir -p ~/Desktop/OpenClaw备份cp -r ~/.openclaw/workspace/* ~/Desktop/OpenClaw备份/ 2>/dev/null完整备份
tar -czf ~/openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/如果你只是随便体验一下,可以忽略这一步~
🚀 方法一:官方一键卸载(快速)
如果你的 openclaw 命令还能正常使用,这是最省事的办法:
步骤 1:执行卸载命令
openclaw uninstall会进入交互式界面:
? 选择要删除的内容 (Press <space> to select, <a> to toggle all)❯◉ Gateway 服务 ◉ 配置文件 ◉ 工作目录 ◉ 缓存数据用空格键勾选所有选项,回车确认:
选择 yes 确认删除,这一步会自动:
✅ 停止 Gateway 服务 ✅ 卸载 systemd/launchd 服务 ✅ 删除 ~/.openclaw/状态目录
步骤 2:删除 npm 全局包
根据你的安装方式执行对应命令:
# npm 安装npm rm -g openclaw# pnpm 安装 pnpm remove -g openclaw# bun 安装bun remove -g openclaw💡 为什么分两步?
openclaw uninstall清理内部数据,但不能删 npm 包;npm 卸载能删命令,但会漏掉服务。两步都要做!
非交互式自动化脚本
适合批量操作或想一键执行:
openclaw uninstall --all --yes --non-interactivenpm rm -g openclaw📋 方法二:手动彻底卸载(最干净)
如果 OpenClaw 已经损坏、uninstall 命令跑不了,或者你想完全掌控每个步骤,并彻底卸载干净,按下面手动操作:
如果遇到这些情况:
openclaw uninstall无法执行CLI 已损坏 想确保彻底清理
按下面手动操作:
阶段1:停止并卸载 Gateway 服务
Gateway 是后台常驻服务,必须先停!
macOS(launchd):
# 停止服务launchctl bootout gui/$UID/bot.molt.gateway 2>/dev/nulllaunchctl bootout gui/$UID/com.openclaw.gateway 2>/dev/null# 删除启动配置rm -f ~/Library/LaunchAgents/bot.molt.gateway.plistrm -f ~/Library/LaunchAgents/com.openclaw.*.plistLinux(systemd):
# 停止并禁用服务systemctl --user disable --now openclaw-gateway.service# 删除服务文件rm -f ~/.config/systemd/user/openclaw-gateway.service# 重载配置systemctl --user daemon-reloadWindows(计划任务):
# 删除计划任务schtasks /Delete /F /TN "OpenClaw Gateway"# 删除启动脚本Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"阶段2:运行官方卸载命令
# 交互式(可勾选保留/删除项)openclaw uninstall# 非交互式(自动化,全删)openclaw uninstall --all --yes --non-interactive# 使用 npx(无需本地安装)npx -y openclaw uninstall --all --yes --non-interactive⚠️ 此步骤会删除
~/.openclaw/目录,数据已备份!
阶段3:删除 CLI 程序
根据安装方式执行对应命令:
# npm 安装npm rm -g openclaw# pnpm 安装pnpm remove -g openclaw# bun 安装bun remove -g openclaw# 权限不足时加 sudo(macOS/Linux)sudo npm rm -g openclawWindows 管理员 PowerShell:
Remove-Item -Recurse -Force "$(npm root -g)\openclaw"macOS 桌面应用:
rm -rf /Applications/OpenClaw.app阶段4:清理历史版本残留(90%用户遗漏!)
OpenClaw 改过两次名,旧版本目录必须手动删(若有):
# Linux/macOS - 删除所有历史版本目录rm -rf ~/.openclawrm -rf ~/.clawdbot # 旧名1rm -rf ~/.moltbot # 旧名2rm -rf ~/.molthub # 相关目录# 检查多配置(profile)rm -rf ~/.openclaw-*rm -rf ~/.clawdbot-*rm -rf ~/.moltbot-*# Windows PowerShellRemove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot"Remove-Item -Recurse -Force "$env:USERPROFILE\.moltbot"Remove-Item -Recurse -Force "$env:USERPROFILE\.molthub"阶段5:深度清理残留(安全关键步骤)
这一步是官方文档未提及、但对安全至关重要的清理!
5.1 清理 npm/node 缓存
# 检查缓存中是否有 openclaw 残留npm cache ls 2>/dev/null | grep openclaw# 如有,清理整个缓存npm cache clean --force# 或者手动删除缓存目录rm -rf ~/.npm/_cacache/content-v2/sha*/*openclaw*5.2 清理环境变量
# 检查环境变量残留env | grep -i openclawenv | grep -i molt# 从 shell 配置中删除# 编辑 ~/.bashrc ~/.zshrc ~/.bash_profile 等文件# 删除包含 openclaw、molt、OPENCLAW 的行5.3 清理 shell 历史(防止API密钥泄露)
# 检查历史记录中是否有密钥grep -i "sk-ant\|sk-proj\|openclaw.*key" ~/.bash_history ~/.zsh_history 2>/dev/null# 清理历史(可选)history | grep -v openclaw > ~/.history_temp && mv ~/.history_temp ~/.bash_history5.4 macOS 专用:检查 Keychain 凭据
# 检查 Keychain 中是否存储了相关凭据security find-generic-password -l "openclaw" 2>/dev/nullsecurity find-generic-password -l "molt" 2>/dev/null# 如有,在"钥匙串访问"应用中手动删除5.5 清理系统临时文件
# Linux/macOSrm -rf /tmp/openclaw*rm -rf /var/tmp/openclaw*rm -rf ~/.cache/openclaw# 日志文件rm -rf ~/.local/share/openclawrm -rf ~/Library/Logs/openclaw🐳 Docker 部署清理
如果你用 Docker 部署,按下面步骤清理:
停止并删除容器
# 停止并删除容器docker stop $(docker ps -a -q --filter "name=openclaw")docker rm $(docker ps -a -q --filter "name=openclaw")删除镜像
# 删除 OpenClaw 镜像docker rmi $(docker images -q "openclaw*")Docker Compose 清理
# 停止并删除容器、网络、卷docker-compose down -v --rmi all删除数据卷(重要!)
# 删除所有 openclaw 相关卷docker volume rm $(docker volume ls -q --filter "name=openclaw") 2>/dev/null# 删除所有未使用的卷(谨慎!)docker system prune -f --volumes 2>/dev/null⚠️ 警告:
docker system prune会删除所有悬空资源,确保你没有其他重要数据再执行!
☁️ 云服务器用户
腾讯云轻量服务器
方式 A:保留服务器,只删应用
登录腾讯云控制台 进入轻量应用服务器 → 选择实例 点击「重置应用」或「重装系统」 选择纯净系统镜像
方式 B:彻底销毁(数据不可恢复)
进入实例详情 点击「更多」→「销毁/退还」 确认销毁
🔴 注意:销毁前务必创建快照或导出配置!
阿里云 ECS
# 使用阿里云 CLI 释放实例(按量付费)aliyun ecs DeleteInstance --InstanceId i-xxxxx --Force true或在控制台:
停止实例 实例列表 → 更多 → 释放设置
🔐 很多人忽略的一步::OAuth 令牌撤销
很多 AI 工具都会连接:
Google GitHub Slack Notion Discord
重要事实:即使你卸载了本地程序,OAuth 令牌仍存储在各服务商服务器上, 授权仍然存在
理论上你的账户仍然可被访问!
建议去各平台撤销授权。常见路径:
各平台 OAuth 撤销操作表
| GitHub | ||
| Slack | ||
| Discord | ||
| Microsoft | ||
| Notion | ||
| Telegram | ||
| 飞书 |
为什么必须手动撤销?
本地卸载 OpenClaw ↓OAuth 令牌仍在云端存活(长期有效!) ↓你的邮件、文件、代码仓库仍可被访问 ↓必须手动撤销每个平台的授权!如果担心安全问题:
🔴 强烈建议:撤销 OAuth 后,修改相关账户密码,特别是怀疑已受攻击的情况。
✅ 卸载检查清单
完成卸载后,按这个清单验证是否彻底:
检查项 1:命令是否已删除
openclaw --version# 预期结果:command not found 或类似错误检查项 2:进程是否还在跑
# Linux/macOSps aux | grep -E "openclaw|clawdbot|moltbot" | grep -v grep# Windowstasklist | findstr openclaw# 预期结果:无相关进程检查项 3:配置目录是否删除
# Linux/macOSls ~/.openclaw 2>&1# Windowsdir %USERPROFILE%\.openclaw# 预期结果:No such file or directory检查项 4:服务是否已移除
# Linuxsystemctl status openclaw# macOSlaunchctl list | grep openclaw# Windowssc query OpenClaw# 预期结果:服务不存在检查项 5:端口是否释放
# 检查 18789 端口netstat -an | grep 18789lsof -i :18789# 预期结果:无占用❓ 常见问题 FAQ
Q1:提示 "EACCES: permission denied" 怎么办?
# macOS/Linux 加 sudosudo npm rm -g openclawsudo rm -rf ~/.openclaw# Windows 以管理员身份运行 PowerShellQ2:只想重装,不想丢配置?
# 只删程序,保留配置npm rm -g openclaw# 保留 ~/.openclaw/ 目录,重装后自动读取或者手动备份:```bash# 备份配置cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)# 重装后恢复cp -r ~/openclaw-backup-xxx ~/.openclawQ3:Docker 容器删不掉,提示 "container is running"
# 强制删除docker kill openclawdocker rm -f openclaw# 如果还删不掉,重启 Docker 服务:sudo systemctl restart dockerQ4:已经卸载了还需要担心什么?
最担心的是 OAuth 令牌! 务必:
检查并撤销所有平台的 OAuth 授权 修改相关账户密码 检查系统是否有异常进程
Q5:如何只删除某个技能(Skill)?
# 列出技能openclaw skill list# 删除指定技能openclaw skill uninstall <技能名称># 或手动删rm -rf ~/.openclaw/skills/<技能名称>最后聊两句
前两周小编在一台闲置旧电脑上刷 Ubuntu 24.04, 部署了 OpenClaw 体验了一段时间
期间也折腾过几次卸载重装。
但用下来感觉: 目前它最大的价值还是 接入聊天平台自动化。
其它功能我在 Agent 上用的更顺手一些
反而会因Token消耗、安全问题、API花费问题感到焦虑😟
如果只是普通用户,还没体验过这波“养虾”,其实不必为这股热潮感到焦虑
个人建议可以继续观望
我反而更推荐你去了解和使用Claude Code 、OpenCode这类AI Agent工具。
🌱 轻松玩科技
以上仅代表个人观点,不喜勿喷
如果这篇文章对你有帮助,
欢迎点击「在看」👍 分享给需要的朋友,或者收藏备用~
如有其他问题,欢迎在评论区留言交流!
本文综合 OpenClaw 官方文档、社区安全报告及多个技术来源整理,最后更新:2026年3月。
夜雨聆风