auto-rollback

# Auto-Rollback Skill 🛡️

This skill makes OpenClaw config changes safe.

Before you edit `~/.openclaw/openclaw.json`, it automatically creates a backup and schedules a rollback job (10 minutes later). If the new config breaks the Gateway and it won’t start, the rollback restores the last known-good config and restarts the Gateway for you — so you don’t need to remote-login to the host to fix a broken config.

Once the Gateway restarts successfully, the pending rollback is automatically cancelled (via the bundled `boot-md` hook running your `BOOT.md`). This prevents an unnecessary rollback after a successful change.

---

这个 skill 的核心价值是让你可以放心改 OpenClaw 配置。

在你修改 `~/.openclaw/openclaw.json` 之前，它会先自动备份，并设置一个 10 分钟后的回滚任务。如果你改坏了配置导致 Gateway 起不来，回滚任务会自动恢复到上一个可用配置并重启 Gateway —— 你不需要再远程登录主机手动修复。

当 Gateway 成功重启起来后，系统会自动取消掉这次预设的回滚（通过内置的 `boot-md` hook 执行 `BOOT.md` 完成），避免“明明已经成功了还被回滚”。

## When to Use / 适用场景

- You (or an agent) are about to change `~/.openclaw/openclaw.json` and restart the Gateway.
- You want a safety net so a bad change won’t take the system down.

---

- 当你（或 agent）要修改 `~/.openclaw/openclaw.json` 并重启 Gateway。
- 你希望即使配置写错，系统也能自动自愈，不用登录主机救火。

## Workflow / 工作流程

1) `start` → backup config + schedule rollback in 10 minutes
2) edit config
3) restart Gateway
4) If restart succeeds → rollback auto-cancels on next successful startup (BOOT.md)
5) If restart fails → wait; rollback restores backup and restarts Gateway automatically

---

1) `start` → 备份配置 + 设置 10 分钟后回滚
2) 修改配置
3) 重启 Gateway
4) 如果启动成功 → 下次成功启动时自动取消回滚（BOOT.md）
5) 如果启动失败 → 等待回滚自动恢复配置并重启 Gateway

## Commands / 命令

### start (before editing) / 修改前执行

```bash
skills/auto-rollback/auto-rollback.sh start --reason "your change description"
```

### ca...