核心用法
Self Updater 是专为 OpenClaw 生态设计的智能自动更新技能,通过 PowerShell 脚本执行。核心工作流包括:检测 OpenClaw 核心与已安装技能的版本更新 → AI 风险评估(5 维度加权计算)→ 根据风险等级自动处理或请求用户确认 → 执行更新并自动重启网关 → 发送智能通知报告。
关键参数组合:
- 手动检查:直接运行脚本,仅检测不更新
- 智能自动更新:
-AutoUpdate -SmartTiming启用空闲等待和 Cron 避让 - 无人值守模式:
-AutoUpdate -SmartTiming -AutoApprove -Quiet适合加入系统定时任务
显著优点
1. 任务零中断设计:独家 Cron-aware 机制读取 ~/.openclaw/cron/jobs.json,主动避让用户定时任务;结合系统空闲检测(默认 5 分钟无活动),确保更新不干扰运行中的爬取或数据处理任务。
2. AI 驱动的风险决策:基于版本影响(30%)、技能数量(25%)、网关重启成本(20%)、距上次更新时间(15%)、Cron 邻近度(10%)五维加权评分,输出低/中/高三档风险,避免盲目自动更新导致的服务中断。
3. 分层权限控制:高风险更新强制用户 60 秒窗口确认,支持 -AutoApprove 参数实现 CI/CD 场景;中低风险可配置自动放行,兼顾安全与效率。
4. 全链路自愈能力:更新后自动检测网关健康状态,异常时尝试重启,配合端口自发现机制,降低运维人工介入成本。
5. 原生通知集成:自动识别 Telegram/Feishu 配置,推送结构化摘要(更新前后对比、风险等级、网关状态),无需额外配置监控告警。
潜在缺点与局限性
- 平台锁定:空闲检测依赖 Windows API,Linux/macOS 环境下核心功能降级或不可用
- 配置文件强依赖:需严格维护
~/.openclaw/cron/jobs.json格式,解析失败时退化为非 Cron-aware 模式,存在误打断任务风险 - AI 评估黑盒化:风险权重公式硬编码,用户无法自定义策略(如特定业务高峰期强制人工审批)
- 超时机制刚性:用户审批 60 秒超时后自动取消,无重试或异步队列设计,可能遗漏关键更新
- 权限要求苛刻:PowerShell ExecutionPolicy Bypass + npm/clawhub CLI 前置依赖,企业安全策略可能阻止执行
适合人群
- OpenClaw 生产环境运维者,需保障爬取任务 SLA
- 个人开发者追求「安装后免维护」体验
- 已有 Telegram/Feishu 协作流的小型团队
- 需要定期安全补丁自动应用但怕更新致损的谨慎用户
常规风险
1. 配置漂移:AutoApprove 模式在高风险场景跳过人工确认,若 AI 评估模型误判可能导致服务中断
2. 网关重启失败:自动重启逻辑依赖端口检测,若配置异常或端口冲突可能进入「已更新但未启动」死锁状态
3. Cron 解析盲区:仅检测 JSON 格式的任务文件,系统级 cron/systemd timer 等外部调度器不可见
4. 供应链风险:通过 npm/clawhub CLI 拉取更新,未提及包完整性校验(如签名验证),存在中间人攻击或恶意包替换可能
5. 静默失败:-Quiet 模式下通知关闭,需依赖外部监控覆盖更新失败场景