✓ Verified 💻 Development ✓ Enhanced Data

Clawdbot Update Plus

Full backup, update, and restore for Clawdbot.

Rating: 4.5 (363 reviews)
Downloads: 4,624 downloads
Version: 1.0.0

Overview

Full backup, update, and restore for Clawdbot.

Complete Documentation

View Source →

🔄 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

bash

# 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

bash

# 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:

bash

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:

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": "[email protected]"
  },
  "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

json

"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

json

"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

bash

clawdbot-update-plus backup

`list-backups` — List Available Backups

bash

clawdbot-update-plus list-backups

`update` — Update Everything

bash

# 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

bash

# 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

bash

clawdbot-update-plus check

`install-cron` — Automatic Updates

bash

# 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:

json

"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

bash

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

# Configure
rclone config

Enable in Config

json

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

Encrypted Backups

json

"encryption": {
  "enabled": true,
  "gpg_recipient": "[email protected]"
}

Logs

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

text

[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)

text

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

Installation

Terminal bash


openclaw install clawdbot-update-plus

Copied!

💻Code Examples

clawdbot-update-plus restore clawdbot-update-2026-01-25-12:00:00.tar.gz

clawdbot-update-plus-restore-clawdbot-update-2026-01-25-120000targz.txt

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

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

git-clone-httpsgithubcomhopykyclawdbot-update-plusgit-clawdbotskillsclawdbot-update-plus.txt

### Add to PATH

Create a symlink to use the command globally:

ln -sf ~/.clawdbot/skills/clawdbot-update-plus/bin/clawdbot-update-plus ~/bin/clawdbot-update-plus

ln--sf-clawdbotskillsclawdbot-update-plusbinclawdbot-update-plus-binclawdbot-update-plus.txt

### 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`:

}

.txt

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

]

.txt

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

]

.txt

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

## Commands

### `backup` — Create Full Backup

clawdbot-update-plus uninstall-cron

clawdbot-update-plus-uninstall-cron.txt

## Notifications

Get notified when updates complete or fail:

}

.txt

Target format determines channel:
- `+1234567890` → WhatsApp
- `@username` → Telegram
- `channel:123` → Discord

## Cloud Storage

### Setup rclone

}

.txt

## Logs

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

[2026-01-25 20:23:43] Notification sent to +1234567890 via whatsapp

2026-01-25-202343-notification-sent-to-1234567890-via-whatsapp.txt

**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)