Clawdbot ToolsDocumentedScanned

update-plus

Full backup, update, and restore for OpenClaw - config, workspace, and skills with auto-rollback

Share:

Installation

npx clawhub@latest install update-plus

View the full skill documentation and source below.

Documentation

🔄 Update Plus

A comprehensive backup, update, and restore tool for your OpenClaw environment. Protect your config, workspace, and skills with automatic rollback, encrypted backups, and cloud sync.

Quick Start

# Check for available updates
update-plus check

# Create a full backup
update-plus backup

# Update everything (creates backup first)
update-plus update

# Preview changes (no modifications)
update-plus update --dry-run

# Restore from backup
update-plus restore openclaw-backup-2026-01-25-12:00:00.tar.gz

Features

FeatureDescription
Full BackupBackup entire environment (config, workspace, skills)
Auto BackupCreates backup before every update
Auto RollbackReverts to previous commit if update fails
Smart RestoreRestore everything or specific parts (config, workspace)
Multi-DirectorySeparate prod/dev skills with independent update settings
Encrypted BackupsOptional GPG encryption
Cloud SyncUpload backups to Google Drive, S3, Dropbox via rclone
NotificationsGet notified via WhatsApp, Telegram, or Discord
Connection RetryAuto-retry on network failure (configurable)

Installation

git clone  ~/.openclaw/skills/update-plus

Add to PATH

mkdir -p ~/bin
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
ln -sf ~/.openclaw/skills/update-plus/bin/update-plus ~/bin/update-plus

Configuration

Create ~/.openclaw/update-plus.json:

{
  "backup_dir": "~/.openclaw/backups",
  "backup_before_update": true,
  "backup_count": 5,
  "backup_paths": [
    {"path": "~/.openclaw", "label": "config", "exclude": ["backups", "logs"]},
    {"path": "~/.openclaw/workspace", "label": "workspace", "exclude": ["node_modules"]}
  ],
  "skills_dirs": [
    {"path": "~/.openclaw/skills", "label": "prod", "update": true}
  ],
  "notifications": {
    "enabled": false,
    "target": "+1234567890"
  },
  "connection_retries": 3,
  "connection_retry_delay": 60
}

Commands

CommandDescription
update-plus checkCheck for available updates
update-plus backupCreate a full backup
update-plus updateUpdate OpenClaw and all skills
update-plus update --dry-runPreview changes
update-plus restore Restore from backup
update-plus install-cronInstall automatic updates (daily 2 AM)
update-plus uninstall-cronRemove cron job

Changelog

v4.0.3

  • Check for updates BEFORE backup (skip backup if already up to date)
  • No more wasted bandwidth/storage when nothing to update

v4.0.2

  • Use curl instead of ping for connection check (more reliable)
  • Works through firewalls and when Mac wakes from sleep

v4.0.1

  • Added Homebrew path detection (/opt/homebrew/bin) for cron jobs
  • Added ~/bin to cron PATH for local symlinks
  • Updated example config with clearer workspace structure

v4.0.0

  • OpenClaw only (removed moltbot/clawdbot legacy support)
  • Simplified configuration and paths
  • Config: ~/.openclaw/update-plus.json

v3.x

  • Multi-bot support (openclaw, moltbot, clawdbot)
  • Connection retry for cron jobs

Author

MIT