
在日常自动化任务与开发工作流中,OpenClaw 是我们得力的助手。但随着项目迭代、环境迁移或遇到配置冲突,卸载重装在所难免。若卸载不彻底,残留的 Agent 记忆与旧配置文件很可能导致下次安装时报错。
OpenClaw 完整卸载指南
本文将系统讲解如何彻底、优雅地卸载 OpenClaw,让你的自动化环境恢复如初。
一、官方推荐:使用 CLI 卸载
通过官方脚本安装的用户,推荐使用 OpenClaw 自带的卸载命令,既安全又快捷,能最大程度保证环境变量平滑过渡。
- 打开终端(Terminal)或命令行工具
- 执行命令:
openclaw uninstall - 系统会提示是否保留本地配置文件和 Agent 数据,根据你的需求选择即可
二、包管理器卸载
若通过 npm 或 Homebrew 安装,需使用对应命令移除:
- npm 用户:
npm uninstall -g openclaw - Homebrew 用户:
brew uninstall openclaw
三、深度清理:移除本地残留数据
执行卸载命令后,主程序虽被移除,但工作区数据(如 SOUL.md 设定、自定义技能脚本、历史对话日志)通常会保留。若需彻底清理,需手动删除这些核心目录。
⚠️ 注意:执行清理前,若工作区中有重要的自动化 Skill 或 Prompt 配置,请务必先将
~/.openclaw文件夹备份至安全位置。
- Linux / macOS:
rm -rf ~/.openclaw # macOS 用户可选清理 rm -rf ~/Library/Application\ Support/OpenClaw - Windows (PowerShell):
Remove-Item -Recurse -Force ~/.openclaw # 若存在 AppData 残留 Remove-Item -Recurse -Force $env:APPDATA\OpenClaw
四、云端及容器化部署的善后
若 OpenClaw 部署在云服务器或容器中:
- 云服务器:在云服务商控制台重置系统盘,或直接释放/销毁实例
- Docker:停止并删除容器,同时删除挂载的数据卷(Volumes)以彻底销毁持久化数据
总结
保持开发和自动化环境纯净,是避免各类奇怪 Bug 的首要原则。按上述步骤操作,你即可轻松掌控 OpenClaw 的去留——无论是为了释放磁盘空间,还是为了迎接一次完美的重装,本指南都能帮你扫清障碍。