auto-rollback

🛡️ 配置修改无忧,失误自动回滚

为 openclaw.json 配置修改提供自动备份与10分钟延迟回滚机制,防止配置错误导致 Gateway 服务中断,保障系统稳定性。

收藏
5.1k
安装
1.1k
版本
1.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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 任务可能因用户权限不足而注册失败

auto-rollback 内容

手动下载zip · 4.6 kB
auto-rollback.shtext/x-shellscript
请选择文件