核心用法
OpenClaw Uninstaller 是一套社区维护的免费卸载工具,专门用于安全、彻底地移除 OpenClaw(龙虾)Gateway 及相关组件。提供三种主要方式:
方式一(推荐):IM 发起的一键卸载。用户通过 WhatsApp/Telegram/Slack 等发送"卸载"指令,Agent 确认后自动执行 schedule-uninstall.sh,约 15 秒后 Gateway 停止并在后台完成清理。支持邮件或 ntfy 通知,可选保留 skills、logs、preferences 等数据。
方式二:残留验证。运行 ./scripts/verify-clean.sh 只读检测,不删除任何文件,输出发现的残留项。
方式三:手动卸载。包括 CLI 命令 openclaw uninstall --all 或分步停止服务、删除状态目录、卸载 CLI、清理系统服务等操作。
显著优点
- 完全免费:明确声明无需任何付费现场或远程清理服务
- 可验证透明:提供可执行脚本验证清理结果,基于官方文档
- 多平台支持:macOS、Linux(含 WSL2),含 headless 环境适配
- 非商业独立:社区维护,与 OpenClaw 官方无商业关联
- 灵活保留:支持备份 skills、logs、credentials 等数据
潜在局限
- Windows 限制:原生 Windows 不支持,需借助 WSL2 或纯手动方式
- Host 要求严格:IM 触发卸载必须
host=gateway,sandbox 环境会导致 one-shot 丢失 - Linux 前置配置:headless Linux 需先运行
loginctl enable-linger - WSL2 降级:无 systemd-run 时回退到 nohup,体验略有差异
- 多 profile 手动处理:各 profile 目录需分别删除
适合人群
- 需要彻底卸载 OpenClaw 的普通用户
- 希望验证系统是否清理干净的技术用户
- 在无 GUI 的服务器/远程 VPS 上操作的管理员
- 对付费清理服务持警惕态度、追求透明方案的用户
常规风险
- 不可逆操作:确认后卸载立即执行,数据丢失风险
- Host 参数误用:未指定
host=gateway导致卸载任务丢失 - 权限问题:sandbox 或权限不足时脚本执行失败
- 远程连接中断:IM 触发后 ~15 秒断开,需 SSH 回连查看结果
- 依赖残留:npm 全局包、系统服务需手动二次确认