🔄 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
CODEBLOCK0
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
CODEBLOCK1
Add to PATH
CODEBLOCK2
Configuration
Create ~/.openclaw/update-plus.json:
CODEBLOCK3
Commands
| Command | Description |
|---|
| INLINECODE1 | Check for available updates |
| INLINECODE2 |
Create a full backup |
|
update-plus update | Update OpenClaw and all skills |
|
update-plus update --dry-run | Preview changes |
|
update-plus restore <file> | Restore from backup |
|
update-plus install-cron | Install automatic updates (daily 2 AM) |
|
update-plus uninstall-cron | Remove 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
Created by hopyky
License
MIT
🔄 Update Plus
一个针对OpenClaw环境的全面备份、更新和恢复工具。通过自动回滚、加密备份和云同步，保护您的配置、工作区和技能。
快速开始
bash
检查可用更新
update-plus check
创建完整备份
update-plus backup
更新所有内容（先创建备份）
update-plus update
预览更改（不执行修改）
update-plus update --dry-run
从备份恢复
update-plus restore openclaw-backup-2026-01-25-12:00:00.tar.gz
功能特性
| 功能 | 描述 |
|---|
| 完整备份 | 备份整个环境（配置、工作区、技能） |
| 自动备份 |
每次更新前自动创建备份 |
|
自动回滚 | 更新失败时自动回滚到上一个提交 |
|
智能恢复 | 恢复全部或特定部分（配置、工作区） |
|
多目录 | 分离生产/开发技能，支持独立更新设置 |
|
加密备份 | 可选的GPG加密 |
|
云同步 | 通过rclone上传备份到Google Drive、S3、Dropbox |
|
通知 | 通过WhatsApp、Telegram或Discord接收通知 |
|
连接重试 | 网络失败时自动重试（可配置） |
安装
bash
git clone https://github.com/hopyky/update-plus.git ~/.openclaw/skills/update-plus
添加到PATH
bash
mkdir -p ~/bin
echo export PATH=$HOME/bin:$PATH >> ~/.zshrc
source ~/.zshrc
ln -sf ~/.openclaw/skills/update-plus/bin/update-plus ~/bin/update-plus
配置
创建 ~/.openclaw/update-plus.json：
json
{
backup_dir: ~/.openclaw/backups,
backupbeforeupdate: 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,
connectionretrydelay: 60
}
命令
| 命令 | 描述 |
|---|
| update-plus check | 检查可用更新 |
| update-plus backup |
创建完整备份 |
| update-plus update | 更新OpenClaw和所有技能 |
| update-plus update --dry-run | 预览更改 |
| update-plus restore
| 从备份恢复 |
| update-plus install-cron | 安装自动更新（每天凌晨2点） |
| update-plus uninstall-cron | 移除定时任务 |
更新日志
v4.0.3
- - 在备份前检查更新（如果已是最新则跳过备份）
- 无需更新时不再浪费带宽/存储空间
v4.0.2
- - 使用curl代替ping进行连接检查（更可靠）
- 可穿透防火墙，Mac从睡眠中唤醒时也能正常工作
v4.0.1
- - 为定时任务添加Homebrew路径检测（/opt/homebrew/bin）
- 为本地符号链接在cron PATH中添加~/bin
- 更新示例配置，工作区结构更清晰
v4.0.0
- - 仅支持OpenClaw（移除了moltbot/clawdbot旧版支持）
- 简化配置和路径
- 配置：~/.openclaw/update-plus.json
v3.x
- - 多机器人支持（openclaw, moltbot, clawdbot）
- 定时任务的连接重试
作者
由 hopyky 创建
许可证
MIT
