← Back to Skills
🔧

Upgrade Guard

🔓Unverified
by jzOcb · v1.0.0 · MITRepository

Safe OpenClaw upgrades with snapshot, pre-flight checks, controlled upgrade steps, post-verification, and emergency rollback. Never lose your working system to a bad update again.

Install on your platform

We auto-selected Claude Code based on this skill’s supported platforms.

1

Run in terminal (recommended)

terminal
claude mcp add upgrade-guard npx -- -y @trustedskills/upgrade-guard
2

Or manually add to ~/.claude/settings.json

~/.claude/settings.json
{
  "mcpServers": {
    "upgrade-guard": {
      "command": "npx",
      "args": [
        "-y",
        "@trustedskills/upgrade-guard"
      ]
    }
  }
}

Requires Claude Code (claude CLI). Run claude --version to verify your install.

About This Skill

What it does

The upgrade-guard skill protects OpenClaw installations from breaking during upgrades. It creates snapshots of the system before an upgrade, performs pre-flight checks for potential issues like plugin renames or dependency breaks, and provides a rollback mechanism if the upgrade fails. This prevents data loss and ensures continued operation even when unexpected problems arise.

When to use it

  • Before any OpenClaw version update: Run upgrade-guard before performing git pull && pnpm install.
  • When upgrading in production environments: The rollback feature is crucial for minimizing downtime during upgrades.
  • To proactively identify upgrade risks: Use the check command to surface potential issues before applying an upgrade.
  • After a failed upgrade attempt: Quickly revert to a known working state using the rollback command.

Key capabilities

  • System snapshotting (version, configuration, plugins, dependencies)
  • Pre-upgrade validation checks (disk space, git status, config validity)
  • Detection of plugin renames (e.g., clawdbot to openclaw)
  • Automated upgrade process with rollback on failure
  • Post-upgrade verification of key components (plugins, channels, models, gateway)

Example prompts

While this skill is primarily command-line driven, you might instruct an AI agent to:

  1. "Run the upgrade-guard snapshot command before I update OpenClaw."
  2. "Execute upgrade-guard check and report any potential upgrade issues."
  3. "If the upgrade-guard upgrade fails, run upgrade-guard rollback immediately."

Tips & gotchas

  • The skill relies on a clean Git repository before initiating an upgrade. Ensure all changes are committed or stashed beforehand.
  • Regularly review the output of the check command to understand potential upgrade risks and adjust configurations accordingly.
View Repository →

Tags

🛡️

TrustedSkills Verification

Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.

Verified Commit564468d4 →

Installing this skill downloads the exact code at commit 564468d4, not the current state of the repository. This prevents supply-chain attacks from unauthorized updates.

Security Audits

Gen Agent Trust HubPass
SocketPass
SnykPass

Details

Version
v1.0.0
License
MIT
Author
jzOcb
Installs
0
Updated
Feb 6, 2026
Published
Feb 4, 2026
Repository (canonical source) →

🔓 Unverified

Not yet reviewed. Use with caution.

Pinned commit564468d4

Install command fetches the verified snapshot, not the live repository.