核心用法
Auto-Updater Pro 是一款面向 Clawdbot 生态的增强型自动更新工具，通过每日定时任务自动完成以下操作：
1. 主程序更新：调用 clawdbot doctor 或包管理器（npm/pnpm/bun）获取最新版本
2. 技能批量更新：执行 clawdhub update --all 同步所有已安装技能
3. 状态报告：通过邮件或消息推送更新摘要
4. 日志追踪：六阶段详细日志写入 ~/.openclaw/workspace/memory/，防止网关重启导致状态丢失
5. 漏执行恢复：配置 missedRunPolicy: "run-immediately" 可在网关离线后自动补执行
关键配置参数
- 调度时间：默认凌晨 4:00（可自定义 cron 表达式）
- 超时设置：建议 600 秒（npm 更新较慢）
- 延迟保护：更新完成后强制等待 30 秒，确保进程完成
显著优点
| 特性 | 说明 |
|------|------|
生产级可靠性 | 六阶段日志 + 磁盘同步等待，彻底解决网关重启中断问题 |
| **断点续更** | missed run recovery 机制避免更新遗漏 |
| **低干扰设计** | 支持邮件报告替代即时消息，减少打扰 |
| **多源兼容** | 同时支持 npm 全局安装与源码 git 更新 |
| **可审计** | 每日独立日志文件，版本变更全程可追溯 |
潜在缺点与局限性
- 单点依赖：需 Gateway 持续运行，虽然支持漏执行恢复，但长时间离线仍可能累积更新延迟
- 权限敏感：npm 全局更新需确保 Gateway 用户具备写权限，多用户环境易触发权限错误
- 网络依赖：技能更新依赖 clawdhub registry 可达性，内网隔离环境需额外配置镜像
- 无回滚机制：更新失败时仅记录日志，不自动回退至上一稳定版本
- 平台限制：仅支持 darwin 与 linux，Windows 环境未覆盖
适合人群
- 长期运行的 Clawdbot 实例管理员：需要最小化人工干预的自动化运维
- 多技能重度用户：订阅了数十个技能的开发者，手动更新成本过高
- 稳定性优先场景：生产环境要求更新过程可追踪、可审计、可恢复
- 跨时区协作团队：利用邮件报告异步同步更新状态，避免即时通讯打扰
常规风险
1. 更新中断风险：npm 安装过程中网关重启可能导致包损坏，虽已缓解但仍建议监控日志
2. 版本冲突风险：技能间依赖版本不兼容时，--all 批量更新可能破坏功能组合
3. 敏感信息泄露：日志文件位于用户目录，多用户系统需注意权限隔离
4. 邮件配置风险：若配套邮件技能配置不当，可能导致 SMTP 凭据暴露于配置文件
建议搭配 clawdbot doctor 定期诊断，并在关键更新前手动执行 --dry-run 预检。