Upgrade Guard

Safe OpenClaw upgrade workflow with pre-flight config check, automatic backup, post-upgrade migration, and rollback. Three modes: cautious (install first, ve...

This skill is a guidance checklist (not code) and appears coherent for upgrading OpenClaw, but consider these practical cautions before following it: - Back up before you run anything (the skill already instructs backups). Verify the backup exists and is readable. - openclaw doctor --fix will modify your config automatically; prefer running doctor --non-interactive first to see proposed changes, or test in a staging environment. - npm install --global modifies your system global packages and may require elevated permissions; avoid running as root unless you understand consequences. - The backup-prune step uses ls | xargs rm -rf scoped to ~/.openclaw/upgrade-guard — double-check the path before running to avoid accidental deletion. - If you deploy OpenClaw in Docker, multiple instances, or via immutable images, follow your platform-specific upgrade process instead (the SKILL explicitly notes Docker and multi-instance are not supported). - Because this is instruction-only, nothing runs automatically from the skill itself — an operator must execute the commands. Review and, if desired, run each command manually or in a safe test environment to confirm behavior. If you want extra safety, snapshot the host/VM or take a filesystem-level backup before performing global installs or restarts.

Type: OpenClaw Skill Name: upgrade-guard Version: 2.2.0 The upgrade-guard skill is a utility designed to facilitate safe upgrades of the OpenClaw software. It includes instructions for the AI agent to perform pre-flight checks, create timestamped backups of configuration files in `~/.openclaw/upgrade-guard`, and verify system health after updates. The shell commands in SKILL.md and references/zh.md are standard administrative tasks (e.g., npm install, cp, mkdir) that align perfectly with the stated goal of preventing configuration breakage during version jumps.