🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Skills Updater
πŸ¦€ ClawHub

Skills Updater

by @thunder1743

Automatically detect, backup, and update OpenClaw skills using caching, retry logic, dry-run mode, and detailed upgrade reports.

Versionv1.1.0
Downloads734
#clawhub
TERMINAL
clawhub install skills-updater

πŸ“– About This Skill

Skills Updater - ζŠ€θƒ½θ‡ͺεŠ¨ε‡ηΊ§ε™¨

θ‡ͺεŠ¨ζ£€ζ΅‹γ€ε€‡δ»½ε’Œε‡ηΊ§ OpenClaw ζŠ€θƒ½οΌŒζ”―ζŒζ™Ίθƒ½ηΌ“ε­˜γ€ι‡θ―•ζœΊεˆΆγ€ι’„ζΌ”ζ¨‘εΌε’Œθ―¦η»†ζŠ₯ε‘Šγ€‚

Automatically detect, update, and manage OpenClaw skills with intelligent caching, backup, and reporting.

Features

βœ… Auto-detection β€” Scans all installed skills and detects available updates βœ… Smart caching β€” 24h TTL cache reduces unnecessary API calls βœ… Automatic backup β€” Creates dated backups before each update βœ… Dry-run mode β€” Preview changes without modifying anything βœ… Detailed reporting β€” Generates upgrade summaries to workspace/memory βœ… Retry logic β€” Exponential backoff handles rate limits gracefully βœ… Security hardened β€” No hardcoded secrets, proper SSL, secure permissions

Installation

clawhub install skills-updater

Usage

Check for updates (no API calls, uses cache)

python3 ~/.openclaw/skills/skills-updater/scripts/check-skill-updates.py --cache-only

Preview updates without making changes

python3 ~/.openclaw/skills/skills-updater/scripts/check-skill-updates.py --dry-run

Auto-upgrade all skills

python3 ~/.openclaw/skills/skills-updater/scripts/check-skill-updates.py --auto

Verbose output

python3 ~/.openclaw/skills/skills-updater/scripts/check-skill-updates.py --auto -v

How It Works

1. Scan Phase β€” Walks through all skill directories and reads version info 2. Cache Check β€” Looks up latest version from cached data (24h old or newer) 3. Detection β€” Identifies skills where current < latest 4. Backup β€” Creates timestamped folder copy of each skill before update 5. Update β€” Downloads and applies latest version from ClawHub 6. Report β€” Writes summary to ~/.openclaw/workspace/memory/skill-upgrades-YYYY-MM-DD.md

Safety

  • Backups always created before real updates (dry-run doesn't backup)
  • Cache permissions set to 700 (owner-only read/write)
  • SSL verification enabled with proper context handling
  • No sensitive data stored or logged
  • Rollback ready β€” all backups preserved on Desktop

    • API Reference

    Command-line Options

    | Flag | Effect | |------|--------| | --cache-only | Use cached data, no API calls | | --dry-run | Show what would update, don't do it | | --auto | Perform actual updates with backups | | -v, --verbose | Show detailed logs | | -h, --help | Display help |

    Exit Codes

  • 0 β€” Success (updates found or completed)
  • 1 β€” Error (API/filesystem failure)
  • 2 β€” No updates available

    • Backup & Recovery

    Updates create backups at: 

    ~/Desktop/skill-backups/
β”œβ”€β”€ skill-name-1.0.0-20260325-094830/
β”œβ”€β”€ skill-name-1.0.0-20260325-120000/
└── ...

    To restore: 

    cp -r ~/Desktop/skill-backups/skill-name-VERSION-TIMESTAMP ~/.openclaw/skills/skill-name

    Configuration

    Edit top of script to customize:

    SKILLS_DIRS = [...]          # Where to look for skills
BACKUP_DIR = ...             # Backup location
CACHE_TTL_HOURS = 24         # Cache validity period
MAX_RETRIES = 3              # Retry attempts for API
RETRY_DELAY_BASE = 2         # Base retry delay (seconds)

    Performance

    Tested performance metrics:

  • Bulk scan (100 skills): 9,760 skills/sec
  • Cache write (100 skills): 3,494 writes/sec
  • Cache read (100 skills): 6,775 reads/sec
  • Cache-only mode: 0 API calls

    • Troubleshooting

    "Connection timeout"

  • Check internet / proxy settings
  • Use --cache-only to work offline

    • "Permission denied on backup"

  • Ensure write access to ~/Desktop/skill-backups/
  • Check disk space

    • "Update failed but backup succeeded"

  • Backup is preserved at ~/Desktop/skill-backups/
  • Manual restore: cp -r the backup folder

    • License

    MIT

    Credits

    Built by 狗剩 (Goason) for OpenClaw.

    Latest Version: 1.1.0 Last Updated: 2026-03-29 Status: Production Ready βœ…

    πŸ’‘ Examples

    Check for updates (no API calls, uses cache)

    python3 ~/.openclaw/skills/skills-updater/scripts/check-skill-updates.py --cache-only

    Preview updates without making changes

    python3 ~/.openclaw/skills/skills-updater/scripts/check-skill-updates.py --dry-run

    Auto-upgrade all skills

    python3 ~/.openclaw/skills/skills-updater/scripts/check-skill-updates.py --auto

    Verbose output

    python3 ~/.openclaw/skills/skills-updater/scripts/check-skill-updates.py --auto -v

    βš™οΈ Configuration

    Edit top of script to customize:

    SKILLS_DIRS = [...]          # Where to look for skills
BACKUP_DIR = ...             # Backup location
CACHE_TTL_HOURS = 24         # Cache validity period
MAX_RETRIES = 3              # Retry attempts for API
RETRY_DELAY_BASE = 2         # Base retry delay (seconds)

    πŸ“‹ Tips & Best Practices

    "Connection timeout"

  • Check internet / proxy settings
  • Use --cache-only to work offline

    • "Permission denied on backup"

  • Ensure write access to ~/Desktop/skill-backups/
  • Check disk space

    • "Update failed but backup succeeded"

  • Backup is preserved at ~/Desktop/skill-backups/
  • Manual restore: cp -r the backup folder