核心用法
OpenClaw Uninstaller 是社区维护的免费卸载工具,提供三种卸载途径:
1. IM 一键卸载(推荐)
用户在 WhatsApp/Telegram/Slack 等 IM 中发送「卸载」,Agent 确认后自动执行 schedule-uninstall.sh。需满足关键前提:host=gateway 必须在主机而非沙箱运行,否则 one-shot 脚本会随 Gateway 停止而丢失。支持邮件/ntfy 通知,可保留技能、日志、凭据等数据。
2. 残留验证verify-clean.sh 只读扫描残留文件,不执行删除,供用户二次确认。
3. 手动卸载
CLI 命令 openclaw uninstall --all --yes --non-interactive 或分步清理服务、状态目录、CLI 工具及 macOS 应用。
显著优点
- 完全免费:明确声明无任何付费上门服务或远程清理
- 透明可验证:所有脚本开源,卸载结果写入
/tmp/openclaw-uninstall.log - 多平台支持:macOS、Linux、WSL2,提供 systemd/launchctl 服务清理命令
- 数据保全:支持
--preserve参数备份技能、日志、凭据至时间戳目录 - IM 友好:对话式交互降低技术门槛,适合非技术用户
潜在局限
- 平台限制:原生 Windows 不支持,需借助 WSL2 或完全手动
- 权限依赖:headless Linux 需预执行
loginctl enable-linger,systemd 缺失时降级 nohup - 沙箱陷阱:常见错误是未指定
host=gateway导致卸载任务丢失,需用户或 Agent 严格遵循文档 - 远程场景复杂:VPS 用户需 SSH 回连查看日志,增加操作链路
适合人群
- 希望彻底清理 OpenClaw 的现有用户
- 对付费清理服务存疑、追求透明方案的用户
- 运维人员批量卸载或验证环境残留
- WSL2/macOS 开发者
常规风险
- 数据丢失:未使用
--preserve将删除所有技能、日志和凭据 - 服务残留:权限不足或沙箱执行可能导致卸载任务未实际运行,误以为已清理
- 多 profile 遗漏:每个自定义 profile 有独立目录,需逐一清理
- IM 会话中断:确认后 Gateway 15 秒内停止,用户需理解这是预期行为而非故障