名称： smart-auto-updater
描述： 具备 AI 驱动影响评估的智能自动更新器。检查更新、分析变更、评估系统影响，并决定是自动更新还是仅生成报告。是实现免手动维护并保障安全性的理想工具。

智能自动更新器

由 AI 驱动的自动更新器，能基于影响评估智能决定是否执行更新。安全、智能且可配置。

功能概述

1. 检查阶段

• 检查 OpenClaw 更新
• 通过 ClawHub 检查技能更新
• 获取变更日志和差异文件

2. AI 分析阶段

• 使用 LLM 分析变更内容
• 评估系统影响（架构/性能/兼容性）
• 划分风险等级（高/中/低）

3. 决策阶段

4. 报告阶段

• 生成易读的更新报告
• 包含风险评估
• 提供升级建议

快速开始

基础用法

# 运行智能更新检查
openclaw sessions spawn \
  --agentId smart-auto-updater \
  --message "运行智能更新检查"

使用自定义参数

openclaw sessions spawn \
  --agentId smart-auto-updater \
  --message "使用自定义设置检查更新：自动更新低风险，报告中风险"

配置

环境变量

# AI 模型 (可选，默认为配置的模型)
export SMART_UPDATER_MODEL="minimax-portal/MiniMax-M2.1"

# 自动更新阈值 (默认: LOW)
# 选项: NONE (仅报告), LOW, MEDIUM
export SMART_UPDATER_AUTO_UPDATE="LOW"

# 风险容忍度 (默认: MEDIUM)
# HIGH: 仅自动更新低风险
# MEDIUM: 自动更新低 + 中风险
# LOW: 自动更新所有风险
export SMART_UPDATER_RISK_TOLERANCE="MEDIUM"

# 报告级别 (默认: detailed)
# 选项: brief, detailed, full
export SMART_UPDATER_REPORT_LEVEL="detailed"

报告格式

高风险报告

🔴 智能自动更新器报告

可用更新: v1.2.3 → v1.3.0

⚠️ 风险等级: 高

📋 变更摘要:
- 检测到破坏性 API 变更
- 需要数据库迁移
- 3 个文件被修改

🏗️ 影响评估:
- 架构: 核心组件发生重大变更
- 性能: 可能影响启动时间
- 兼容性: 破坏向后兼容性

🚫 决策: 已跳过

💡 建议:
1. 手动审查变更日志
2. 在测试环境中验证
3. 安排维护窗口

🗓️ 下次检查: 24 小时后

低风险自动更新报告

🟢 智能自动更新器报告

已更新: v1.2.3 → v1.2.4

✅ 风险等级: 低

📋 变更:
- 错误修复 (2 项)
- 性能改进 (1 项)

🏗️ 影响评估:
- 架构: 无变更
- 性能: 轻微改进
- 兼容性: 完全兼容

✅ 决策: 已自动更新

📊 摘要:
- OpenClaw: v1.2.3 → v1.2.4
- 已更新技能: 2 个
- 未变更技能: 15 个
- 错误: 无

⏱️ 下次检查: 24 小时后

架构

┌──────────────────┐
│  触发器 (定时任务) │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│   检查更新        │ ← clawhub update --dry-run
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│   AI 分析        │ ← 分析变更，评估风险
└────────┬─────────┘
         │
    ┌────┴────┐
    │         │
    ▼         ▼
┌───────┐  ┌───────┐
│  高   │  │  中   │
│ 跳过  │  │ 跳过  │
└───┬───┘  └───┬───┘
    │          │
    ▼          ▼
┌───────┐  ┌───────┐
│  低   │  │ 仅报告 │
│ 更新  │  │       │
└───┬───┘  └───────┘
    │          │
    └────┬─────┘
         │
         ▼
┌──────────────────┐
│   生成报告       │ ← 发送摘要
└──────────────────┘

安全特性

1. 先执行模拟运行 - 操作前必先检查
2. 风险分级 - AI 驱动的全面影响评估
3. 可配置阈值 - 根据自身风险容忍度设置
4. 详细日志记录 - 记录每个决策过程
5. 手动覆盖 - 始终可在更新前进行人工审查

故障排除

更新持续被跳过

• 检查风险容忍度设置
• 确认 AI 模型可用
• 手动审查变更日志

误报过多（高风险过多）

• 降低风险容忍度
• 检查 AI 模型提示词
• 审查特定变更模式

报告未送达

• 验证交付渠道配置
• 检查网关状态
• 审查会话配置

参考文档

• references/risk-assessment.md → AI 风险评估方法论
• references/report-templates.md → 报告格式示例
• references/integration.md → 与定时任务/作业的集成