Source Code

🔄 Clawdbot Update Plus

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

Quick Start

# Check for available updates
clawdbot-update-plus check

# Create a full backup
clawdbot-update-plus backup

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

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

# Restore from backup
clawdbot-update-plus restore clawdbot-update-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
Modular Architecture	Clean, maintainable codebase

Installation

# Via ClawdHub
clawdhub install clawdbot-update-plus --dir ~/.clawdbot/skills

# Or clone manually
git clone https://github.com/hopyky/clawdbot-update-plus.git ~/.clawdbot/skills/clawdbot-update-plus

Add to PATH

Create a symlink to use the command globally:

mkdir -p ~/bin
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
source ~/.zshrc
ln -sf ~/.clawdbot/skills/clawdbot-update-plus/bin/clawdbot-update-plus ~/bin/clawdbot-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 ~/.clawdbot/clawdbot-update.json:

{
  "backup_dir": "~/.clawdbot/backups",
  "backup_before_update": true,
  "backup_count": 5,
  "backup_paths": [
    {"path": "~/.clawdbot", "label": "config", "exclude": ["backups", "logs", "media", "*.lock"]},
    {"path": "~/clawd", "label": "workspace", "exclude": ["node_modules", ".venv"]}
  ],
  "skills_dirs": [
    {"path": "~/.clawdbot/skills", "label": "prod", "update": true},
    {"path": "~/clawd/skills", "label": "dev", "update": false}
  ],
  "remote_storage": {
    "enabled": false,
    "rclone_remote": "gdrive:",
    "path": "clawdbot-backups"
  },
  "encryption": {
    "enabled": false,
    "gpg_recipient": "your-email@example.com"
  },
  "notifications": {
    "enabled": false,
    "target": "+1234567890",
    "on_success": true,
    "on_error": true
  }
}

Backup Paths

Configure what to backup with backup_paths:

Option	Description
`path`	Directory to backup (supports `~`)
`label`	Name in logs and restore
`exclude`	Files/folders to exclude

Recommended Setup

"backup_paths": [
  {"path": "~/.clawdbot", "label": "config", "exclude": ["backups", "logs", "media"]},
  {"path": "~/clawd", "label": "workspace", "exclude": ["node_modules", ".venv"]}
]

Skills Update

Configure which skills to update with skills_dirs:

Option	Description
`path`	Skills directory
`label`	Name in logs
`update`	Run `git pull` (true/false)

Recommended Setup

"skills_dirs": [
  {"path": "~/.clawdbot/skills", "label": "prod", "update": true},
  {"path": "~/clawd/skills", "label": "dev", "update": false}
]

Prod: Auto-update from ClawdHub/GitHub
Dev: Manual only (protects your work)

Commands

`backup` — Create Full Backup

clawdbot-update-plus backup

`list-backups` — List Available Backups

clawdbot-update-plus list-backups

`update` — Update Everything

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

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

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

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

`restore` — Restore from Backup

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

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

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

# Force (no confirmation)
clawdbot-update-plus restore backup.tar.gz --force

`check` — Check for Updates

clawdbot-update-plus check

`install-cron` — Automatic Updates

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

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

# Remove
clawdbot-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

Cloud Storage

Setup rclone

# Install
brew install rclone  # macOS
curl https://rclone.org/install.sh | sudo bash  # Linux

# Configure
rclone config

Enable in Config

"remote_storage": {
  "enabled": true,
  "rclone_remote": "gdrive:",
  "path": "clawdbot-backups"
}

Encrypted Backups

"encryption": {
  "enabled": true,
  "gpg_recipient": "your-email@example.com"
}

Logs

All operations are logged to ~/.clawdbot/backups/update.log:

[2026-01-25 20:22:48] === Update started 2026-01-25 20:22:48 ===
[2026-01-25 20:23:39] Creating backup...
[2026-01-25 20:23:39] Backup created: clawdbot-update-2026-01-25-20:22:48.tar.gz (625M)
[2026-01-25 20:23:39] Clawdbot current version: 2026.1.22
[2026-01-25 20:23:41] Starting skills update
[2026-01-25 20:23:41] === Update completed 2026-01-25 20:23:41 ===
[2026-01-25 20:23:43] Notification sent to +1234567890 via whatsapp

Log retention: Logs older than 30 days are automatically deleted.

Retention Policy

Type	Retention	Config
Backups (local)	Last N backups	`backup_count: 5`
Backups (remote)	Last N backups	Same as local
Logs	30 days	Automatic

Architecture (v2.0)

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

Changelog

v2.0.0

Complete architecture rewrite
Modular design (7 separate modules)
Cleaner codebase (~150 lines per module vs 1000+ monolith)
Better error handling
Improved restore with label support
Auto-detect notification channel from target format
Fixed --no-backup flag being ignored
Detailed logging to file with auto-purge
Backup retention policy (local + remote)

v1.7.0

Smart restore with label support
Auto-detect backup format

v1.6.0

Added backup_paths for full environment backup
Separated backup logic from update logic

v1.5.0

Multi-directory support (skills_dirs)

v1.4.0

Notifications via Clawdbot messaging

v1.3.0

Added check, diff-backups, install-cron commands

Author

Created by hopyky

License

MIT

clawdbot-update-plus

🔄 Clawdbot Update Plus

Quick Start

Features

Installation

Add to PATH

Dependencies

Configuration

Backup Paths

Recommended Setup

Skills Update

Recommended Setup

Commands

backup — Create Full Backup

list-backups — List Available Backups

update — Update Everything

restore — Restore from Backup

check — Check for Updates

install-cron — Automatic Updates

Notifications

Cloud Storage

Setup rclone

Enable in Config

Encrypted Backups

Logs

Retention Policy

Architecture (v2.0)

Changelog

v2.0.0

v1.7.0

v1.6.0

v1.5.0

v1.4.0

v1.3.0

Author

License

`backup` — Create Full Backup

`list-backups` — List Available Backups

`update` — Update Everything

`restore` — Restore from Backup

`check` — Check for Updates

`install-cron` — Automatic Updates