Self-Upgrade Skill for Openclaw

An automated maintenance and self-iteration engine designed to keep your AI agent system secure, updated, and error-free.

fffdz
v1.0.0
Mar 1, 2026
0
586
1

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install tianyi-self-upgrade

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install tianyi-self-upgrade using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Self-Upgrade Skill?

The Self-Upgrade skill provides a robust framework for the autonomous maintenance and evolutionary growth of your AI agent environment. By integrating advanced version tracking and automated configuration migration, this component of Openclaw Skills ensures that your system remains compatible with the latest standards without manual intervention. It categorizes operations into specific risk levels, ensuring that critical changes like service restarts require explicit user authorization while low-risk tasks like log cleaning are handled automatically.

This skill is fundamental for developers looking to minimize technical debt and system downtime. It leverages a progressive execution strategy, meaning every update step is validated before the next begins. With built-in backup and rollback mechanisms, the Self-Upgrade skill offers a safety net that protects user configurations and installed skills during complex migration processes.

Self-Upgrade Skill Use Cases

  • Automating the repair of deprecated configuration fields after a core system update.
  • Performing periodic health checks and log rotations to maintain peak performance.
  • Ensuring all required dependency skills are present and correctly configured in your environment.
  • Running preventive diagnostics via the doctor command to identify potential issues before failures occur.
  • Synchronizing local npm packages with the required versions for your specific Openclaw Skills.

How Self-Upgrade Skill Works

  1. The system performs a version check of both the binary and the configuration metadata to identify necessary updates.
  2. Configuration migration scripts detect deprecated fields and transform them into the latest supported schema.
  3. A dependency audit is conducted to verify that all necessary skill packages and npm modules are present.
  4. The skill executes an automated diagnostic and fix routine to resolve detected environment issues.
  5. A comprehensive backup of the existing configuration is created before any medium or high-risk changes are applied.
  6. A detailed upgrade report is generated, providing the user with a summary of changes, backup locations, and validation results.

Self-Upgrade Skill Setup

To begin using this maintenance tool within your Openclaw Skills environment, ensure you have the core CLI installed. You can trigger the manual upgrade and fix process using the following command:

openclaw doctor --fix

For automated maintenance via the included PowerShell script, use the desired flags to control the execution mode:

.\scripts\self-upgrade.ps1 -Auto -BackupDir "~\.openclaw\backups"

Self-Upgrade Skill Data Schema & Taxonomy

The Self-Upgrade skill manages its lifecycle through a structured metadata and backup system. It primarily interacts with the main configuration file and maintains a history of changes.

Component Path Description
Config File ~/.openclaw/openclaw.json Primary configuration containing system settings and version info.
Backup Storage ~/.openclaw/backups/ Directory containing timestamped JSON backups for easy rollbacks.
Upgrade History references/upgrade-history.md A detailed log of all past upgrade actions, timestamps, and results.
Schema Definition references/config-schema.md The source of truth for valid configuration structures used during migration.

Self-Upgrade Skill Advanced Features

  • Automated risk-level classification to distinguish between silent background tasks and user-authorized upgrades.
  • Dry-run mode allowing developers to preview changes and migrations without modifying any files.
  • Granular rollback mechanism to revert the system to specific timestamped configuration states in case of failure.
  • Backward-compatibility logic that preserves deprecated fields during transitions to prevent breaking changes.
  • Multi-skill dependency verification to ensure a healthy ecosystem within your Openclaw Skills collection.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*