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

Installation

git clone https://github.com/hopyky/update-plus.git ~/.openclaw/skills/update-plus

Add to PATH

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

Dependencies

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", "media"]},
    {"path": "~/.openclaw/workspace", "label": "workspace", "exclude": ["node_modules", ".venv"]}
  ],
  "skills_dirs": [
    {"path": "~/.openclaw/skills", "label": "prod", "update": true}
  ],
  "remote_storage": {
    "enabled": false,
    "rclone_remote": "gdrive:",
    "path": "openclaw-backups"
  },
  "encryption": {
    "enabled": false,
    "gpg_recipient": "your-email@example.com"
  },
  "notifications": {
    "enabled": false,
    "target": "+1234567890",
    "on_success": true,
    "on_error": true
  },
  "connection_retries": 3,
  "connection_retry_delay": 60
}

Connection Retry

For cron jobs running at night when the network might be unstable:

Commands

backup — Create Full Backup

update-plus backup

list-backups — List Available Backups

update-plus list-backups

update — Update Everything

# Standard update (with automatic backup)
update-plus update

# Preview changes only
update-plus update --dry-run

# Skip backup
update-plus update --no-backup

# Force continue even if backup fails
update-plus update --force

restore — Restore from Backup

# Restore everything
update-plus restore backup.tar.gz

# Restore only config
update-plus restore backup.tar.gz config

# Restore only workspace
update-plus restore backup.tar.gz workspace

check — Check for Updates

update-plus check

install-cron — Automatic Updates

# Install daily at 2 AM
update-plus install-cron

# Custom schedule
update-plus install-cron "0 3 * * 0"  # Sundays at 3 AM

# Remove
update-plus uninstall-cron

Notifications

Get notified when updates complete or fail:

"notifications": {
  "enabled": true,
  "target": "+1234567890",
  "on_success": true,
  "on_error": true
}

Target format determines channel:

• +1234567890 → WhatsApp
• @username → Telegram
• channel:123 → Discord

Architecture

bin/
├── update-plus              # Main entry point
└── lib/
    ├── utils.sh             # Logging, helpers, connection retry
    ├── config.sh            # Configuration
    ├── backup.sh            # Backup functions
    ├── restore.sh           # Restore functions
    ├── update.sh            # Update functions
    ├── notify.sh            # Notifications
    └── cron.sh              # Cron management

Changelog

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
• Backups named: openclaw-backup-YYYY-MM-DD-HH:MM:SS.tar.gz

v3.x

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

v2.x

• Modular architecture
• Smart package manager detection

Author

Created by hopyky

License

MIT