核心用法
Safe Update 是一个面向 OpenClaw 开发者的源码级更新工具,提供从 Git 仓库拉取、构建到服务重启的完整自动化流程。核心能力包括:
1. 智能状态分析:执行前自动检测未提交变更、本地修改与上游新提交,基于当前工作区状态推荐最优更新策略(merge/rebase)
2. 配置自动备份:强制备份 openclaw.json 与 auth-profiles.json 至时间戳目录,支持灾难恢复
3. 多模式更新:支持 merge(安全保守)、rebase(历史整洁)两种策略,Dry-run 模式零风险预览
4. 服务无缝衔接:构建完成后自动重装 systemd 服务并交互式确认重启
显著优点
- 风险前置管控:强制备份 + 策略推荐 + 用户二次确认的三层防护
- 开发者友好:分支级更新支持,适配 feature 开发与主线同步场景
- 可回滚设计:备份文件保留原始配置,异常时可快速恢复
潜在局限
- 强制操作风险:包含
git push --force与systemctl restart,误操作可能导致数据丢失或服务中断 - 依赖外部状态:需预装 git/npm/systemctl,且上游仓库可访问
- 冲突处理人工介入:rebase 冲突时需手动解决,自动化流程中断
适合人群
- OpenClaw 源码贡献者与高级用户
- 需要定制构建或跟踪开发分支的技术团队
- 具备 Git 冲突解决能力的运维人员
常规风险
⚠️ 关键风险点:
npm i -g .可能污染全局 Node 模块- 服务重启期间 OpenClaw Gateway 不可用
- 未正确配置环境变量时可能操作错误仓库路径