Update Plus

核心用法

Update Plus 是专为 OpenClaw 设计的综合性环境管理工具，提供从备份、更新到恢复的一站式解决方案。核心工作流遵循"先备份、后更新、自动回滚"的安全模式：

1. 检查更新：update-plus check 智能检测可用更新，避免无效备份
2. 创建备份：update-plus backup 全量打包配置、工作区和技能目录
3. 安全更新：update-plus update 自动创建备份后执行更新，失败时自动回滚
4. 灵活恢复：update-plus restore <备份文件> 支持全量或选择性恢复

显著优点

• 零配置风险：Auto-backup + Auto-rollback 双保险机制，更新失败自动还原
• 精细化控制：支持多目录独立管理（prod/dev 环境分离）、排除规则（如 node_modules）
• 企业级扩展：GPG 加密、rclone 云同步（Google Drive/S3/Dropbox）、多通道通知（WhatsApp/Telegram/Discord）
• 网络容错：自动重试机制应对不稳定网络，curl 替代 ping 穿透防火墙
• 定时自动化：内置 cron 管理，支持每日凌晨 2 点自动更新

潜在缺点与局限

• 单点依赖：4.0.0 版本后移除多 bot 支持（moltbot/clawdbot），仅兼容 OpenClaw
• 外部工具链：依赖 git、jq、rsync，Windows 环境需额外配置
• 云同步门槛：rclone 需手动配置 OAuth/API 密钥，新手有一定学习成本
• 通知隐私风险：WhatsApp/Telegram 需绑定真实联系方式，存在隐私泄露隐患

适合人群

• OpenClaw 重度用户，拥有大量自定义技能和复杂配置
• 需要区分生产/开发环境的多目录管理者
• 追求自动化运维、希望定时无人值守更新的效率用户
• 对数据安全敏感、需要异地备份的企业/团队用户

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 备份文件泄露 | 未加密备份包含敏感配置 | 启用 GPG 加密，设置强密码 |

| 云同步凭证暴露 | rclone 配置可能包含明文 token | 限制备份目录权限 600，定期轮换密钥 |

| 自动更新中断 | 定时任务依赖网络，可能累积失败 | 启用通知渠道，定期检查日志 |

| 版本兼容性 | 4.x 与旧版配置不兼容 | 升级前手动迁移 v3.x 多 bot 配置 |

核心功能

update-plus 是专为 OpenClaw 设计的运维级工具，集备份、更新、恢复于一体。核心能力包括：

• 智能备份：完整备份配置、工作区与技能目录，支持自定义排除规则与 GPG 加密
• 自动回滚：更新前自动创建备份，失败时一键恢复，避免环境损坏
• 多环境管理：支持 prod/dev 技能目录分离，独立配置更新策略
• 云同步：通过 rclone 将备份上传至 Google Drive、S3、Dropbox
• 通知机制：集成 WhatsApp、Telegram、Discord 实时推送状态

显著优点

1. 防御性设计：「先备份后更新」的强制流程大幅降低操作风险；v4.0.3 优化为先检查更新再决定是否备份，避免无效存储
2. 网络容错：curl 替代 ping 检测连接，穿透防火墙；支持失败后自动重试（默认 3 次，间隔 60 秒）
3. 配置灵活：JSON 配置驱动，路径、排除项、加密、通知均可自定义，适应复杂目录结构
4. 零依赖风险：仅使用系统标准工具（git、rsync、jq、tar），无第三方 npm 包引入

潜在局限

1. 手动维护成本：cron 自动更新虽方便，但需先验证手动流程稳定，否则可能夜间故障无人感知
2. 云同步依赖 rclone：rclone 需单独配置 OAuth/密钥，对新手有一定门槛
3. GPG 加密可选：默认不加密，敏感环境需主动开启
4. 限于 OpenClaw：v4.0.0 起移除多 bot 支持（moltbot/clawdbot），专注 OpenClaw 生态

适合人群

• 重度 OpenClaw 用户：频繁更新技能、自定义 workspace 的开发者
• 团队协作者：需要同步多成员环境或保留历史版本的场景
• 风险厌恶型用户：无法承受配置丢失，追求「可回滚」的安全感

常规风险

• 备份目录膨胀：backup_count 默认仅保留 5 份，大仓库长期运行可能占满磁盘，需监控
• --force 模式慎用：restore 时跳过确认可能误覆盖，生产环境建议始终交互确认
• cron 环境差异：v4.0.1 已修复 Homebrew 路径检测，但仍建议首次启用后手动验证日志

使用建议

首次使用顺序：check → backup → 验证备份 → update --dry-run → update。启用加密前确保 GPG 密钥可用，自动更新前至少完成 3 次手动更新无异常。