Auto-Updater Skill

Auto-Updater Skill 是什么

Auto-Updater Skill 为 Clawdbot/OpenClaw 环境建立每日无人值守更新：检测安装方式，更新主程序和全部 Skill，运行 doctor，再把成功、失败与版本变化发送给用户。它解决“长期代理环境悄悄过期”的问题，但也把依赖升级风险带入定时任务。

适用场景与不适用场景

适合有持续运行 gateway、愿意接受自动升级并能处理回归的个人环境。不适合生产关键系统、严格变更窗口或无法随时回滚的机器。元数据只声明 Darwin/Linux，Windows 不应假设兼容。

核心能力与工作机制

默认凌晨 4 点创建 cron 任务，可配置时间、时区和投递方式。主程序按 npm、pnpm、bun 或源码安装更新，随后运行 doctor；Skills 通过 clawdhub update –all 更新。还支持 dry-run、版本查看、任务列表和删除。

实际工作流与产物

先 dry-run 展示将更新的对象，再确认计划时间与通知目标；创建任务后检查 cron list。每次运行在隔离会话中执行，记录版本、更新、健康检查和错误，最后投递摘要。若 gateway 未持续运行或 cron 被禁用，任务不会按期发生。

安装、依赖与权限

需要 Clawdbot/OpenClaw、clawdhub、包管理器、网络、全局安装目录与 Skills 目录写权限，以及常驻 gateway 的 cron 能力。权限足以修改可执行代码，必须视为高影响运维权限。

限制、风险与使用建议

无人值守升级可能引入供应链风险、破坏兼容性或在夜间造成不可用。update –all 扩大了变更面；doctor 通过也不能证明业务流程正常。高价值环境应改为只检测或 dry-run，由人审核版本与发布说明后再更新。

上手建议

先连续几天使用 dry-run 和手动更新，确认摘要、回滚与备份可靠，再考虑启用自动模式。固定时区，避免夏令时误解；保留上一版本和技能快照。失败时先暂停或删除计划任务，修复后再恢复。

来源、版本与许可

依据 ClawHub 页面、1.0.0 Skill 与代理指南整理，页面声明 MIT-0、显示 Review；平台 API 自动审核为 clean，但不等同供应链安全保证。

常见问题

1. 默认什么时候运行？

默认每天凌晨 4 点，但应明确时区并检查计划任务实际保存值。跨时区或夏令时环境可能与直觉不一致，创建后要用任务列表核验。

2. 会更新哪些内容？

会按安装方式更新主程序，运行 doctor，并用 clawdhub update –all 更新全部 Skills。它不是只检查一个包，因此变更面较大。

3. 可以先预览吗？

可以，先用 dry-run 查看将发生的更新并验证环境。建议至少完成一次人工更新、备份与回滚演练，再决定是否允许无人值守执行。

4. 为什么 gateway 必须常驻？

计划任务由该环境的 cron 能力触发；gateway 未运行或 cron.enabled 关闭时，配置仍可能存在但不会执行。出现漏跑先检查这两项。

5. 支持 Windows 吗？

当前元数据只列 Darwin/Linux，因此不能把示例直接套到 Windows。Windows 用户应等待明确支持，或自行建立受控更新流程并承担兼容验证。

6. doctor 通过是否代表没有回归？

不代表。doctor 主要检查环境健康，业务插件、认证和工作流仍可能变化。更新后应运行代表性的读写测试并检查通知通道。

7. 如何停用自动更新？

可删除对应 cron job，或在需要时关闭 cron。停用前记录任务标识，停用后用列表确认不再存在，不能只依赖没有收到通知。

8. 生产环境应如何使用？

更稳妥的做法是定时只检查版本并发摘要，由人审批后在维护窗口更新。保存旧版本与 Skills 快照，并准备快速回滚。