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

Feature	Description
Full Backup	Backup entire environment (config, workspace, skills)
Auto Backup	Creates backup before every update
Auto Rollback	Reverts to previous commit if update fails
Smart Restore	Restore everything or specific parts (config, workspace)
Multi-Directory	Separate prod/dev skills with independent update settings
Encrypted Backups	Optional GPG encryption
Cloud Sync	Upload backups to Google Drive, S3, Dropbox via rclone
Notifications	Get notified via WhatsApp, Telegram, or Discord
Connection Retry	Auto-retry on network failure (configurable)

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

Dependency	Required	Purpose
git	Yes	Update skills from repositories
jq	Yes	Parse JSON configuration
rsync	Yes	Efficient file copying
rclone	No	Cloud storage sync
gpg	No	Backup encryption

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:

Option	Default	Description
connection_retries	3	Number of retry attempts
connection_retry_delay	60	Seconds between retries

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