核心用法
Auto-Rollback Skill 是专为 OpenClaw 系统设计的配置安全保护机制。当 Agent 需要修改 ~/.openclaw/openclaw.json 配置并重启 Gateway 时,该技能通过以下标准化流程确保安全:
1. 启动保护:执行 auto-rollback.sh start --reason "说明",自动创建带时间戳的配置备份,并注册 10 分钟后执行的 launchd 定时回滚任务
2. 执行修改:编辑配置文件并重启 Gateway
3. 健康验证:检查 Gateway 是否正常启动
4. 结果处理:验证成功则调用 cancel 取消回滚;失败则不操作,等待自动回滚恢复
CLI 命令体系
start:创建备份并启动倒计时回滚cancel:手动取消待执行的回滚任务status:查看当前回滚状态
显著优点
- 零配置安全网:无需复杂设置,一条命令即获得完整回滚保护
- 延迟确认机制:10分钟缓冲期给予充分的验证时间,避免即时回滚的误判
- 多维度触发支持:支持命令行调用、语音口令("取消回滚"/"cancel rollback"等)多种取消方式
- 完整审计追踪:备份文件、状态文件、日志分离存储,便于故障排查
- Agent 原生集成:提供标准 Python 集成模式,可无缝嵌入自动化工作流
潜在局限
- 平台限制:依赖 macOS launchd,仅支持 darwin/linux 系统,Windows 用户无法使用
- 外部依赖:需要预装 bash、launchctl、jq 等二进制工具
- 固定回滚窗口:10分钟延迟不可动态调整,对于快速迭代的场景可能偏保守
- 单点故障风险:若 launchd 任务本身注册失败,回滚保护将失效
- 无自动健康检测:需 Agent/用户主动验证 Gateway 状态,非全自动闭环
适合人群
- 频繁调整 OpenClaw 配置的开发者与运维人员
- 对服务可用性要求较高的生产环境管理员
- 希望通过自动化降低人为操作风险的 Agent 使用者
常规风险
- 忘记 cancel:成功修改后未取消回滚,导致配置被意外还原
- 验证不充分:Gateway 表面启动但实际功能异常,错过回滚窗口
- 并发修改冲突:多进程同时操作可能导致备份/回滚状态混乱
- 磁盘空间:长期积累的备份文件可能占用存储空间,需定期清理
- 权限问题:launchd 任务可能因用户权限不足而注册失败