Released: 2026-05-01
Price: $4.99
Category: operations
What It Does
Upgrade Rollback Doctor makes OpenClaw upgrades reversible. Before you upgrade, it runs preflight checks — capturing your current version, git state, key files, disk space, and skill inventory as a restore point. After you upgrade, it runs smoke tests across Python, git, config files, and skill scripts to verify everything still works. If something breaks, you get an explicit, human-executable rollback checklist with no guesswork.
Key Features
Preflight Mode
Run before upgrading to capture a complete readiness snapshot: current version and git status, Python version check, key file inventory, disk space, and list of installed skills (up to 20 skill scripts syntax-checked via py_compile).
Smoke Test Mode
Run after upgrading to verify the new version is healthy: Python version, git workspace status, key config and memory files present, skill scripts syntax-valid. Summary verdict: PASS or FAIL with specific failing items listed.
Rollback Checklist Generation
When smoke tests fail, the tool produces a prioritised, human-readable rollback checklist covering steps to restore from the preflight snapshot, which files or skills failed validation, git commands to revert, and confirmation steps.
JSON Report Output
Both preflight and smoke results write structured JSON to --out for archiving, diffing, and handoff to the Slider verification step.
Usage
python3 scripts/upgrade_rollback_doctor.py preflight --workspace /root/.openclaw/workspace --out preflight.json
python3 scripts/upgrade_rollback_doctor.py smoke --workspace /root/.openclaw/workspace --out smoke.jsonRequirements
- OpenClaw v2026.3.23+
- Python 3.8+
- No third-party dependencies — Python stdlib only
- No API keys required · No network access needed
QA and Security Notes
Viper QA passed (5/5) and Warlock security cleared this release on 2026-05-01. subprocess.run() uses fixed argument lists only — no shell=True, no user-controlled input. All subprocess calls bounded by timeout=15. No network, no secrets, no destructive writes. PACKAGED_PROD_VERIFIED.