AI-powered auto-updater that intelligently decides whether to update based on impact assessment. Safe, intelligent, and configurable.

What it does

1. Check Phase

• Checks for OpenClaw updates
• Checks for skill updates via ClawHub
• Fetches changelog and diff

2. AI Analysis Phase

• Analyzes changes using LLM
• Evaluates system impact (架构/性能/兼容性)
• Classifies risk level (HIGH/MEDIUM/LOW)

3. Decision Phase

4. Report Phase

• Generates readable update report
• Includes risk assessment
• Provides upgrade recommendations

Quick Start

Basic usage

# Run smart update check
openclaw sessions spawn \
  --agentId smart-auto-updater \
  --message "Run smart update check"

With custom parameters

openclaw sessions spawn \
  --agentId smart-auto-updater \
  --message "Check updates with custom settings: auto-update LOW risk, report MEDIUM risk"

Configuration

Environment Variables

# AI Model (optional, defaults to configured model)
export SMART_UPDATER_MODEL="minimax-portal/MiniMax-M2.1"
# Auto-update threshold (default: LOW)
# Options: NONE (report only), LOW, MEDIUM
export SMART_UPDATER_AUTO_UPDATE="LOW"
# Risk tolerance (default: MEDIUM)
# HIGH: Only auto-update LOW risk
# MEDIUM: Auto-update LOW + MEDIUM risk
# LOW: Auto-update all
export SMART_UPDATER_RISK_TOLERANCE="MEDIUM"
# Report level (default: detailed)
# Options: brief, detailed, full
export SMART_UPDATER_REPORT_LEVEL="detailed"

Report Format

High Risk Report

🔴 Smart Auto-Updater Report
Update Available: v1.2.3 → v1.3.0
⚠️ Risk Level: HIGH
📋 Changes Summary:
Breaking API changes detected
Database migration required
3 files modified
🏗️ Impact Assessment:
Architecture: MAJOR changes to core components
Performance: Potential impact on startup time
Compatibility: Breaks backward compatibility
🚫 Decision: SKIPPED
💡 Recommendations:
Review changelog manually
Test in staging environment
Schedule maintenance window
🗓️ Next Check: 24 hours

Low Risk Auto-Update

🟢 Smart Auto-Updater Report
Updated: v1.2.3 → v1.2.4
✅ Risk Level: LOW
📋 Changes:
Bug fixes (2)
Performance improvements (1)
🏗️ Impact Assessment:
Architecture: No changes
Performance: Minor improvement
Compatibility: Fully compatible
✅ Decision: AUTO-UPDATED
📊 Summary:
OpenClaw: v1.2.3 → v1.2.4
Skills updated: 2
Skills unchanged: 15
Errors: none
⏱️ Next Check: 24 hours

Architecture

┌──────────────────┐
│  Trigger (Cron)  │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  Check Updates    │ ← clawhub update --dry-run
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  AI Analysis     │ ← Analyze changes, assess risk
└────────┬─────────┘
         │
    ┌────┴────┐
    │         │
    ▼         ▼
┌───────┐  ┌───────┐
│ HIGH  │  │ MEDIUM│
│ Skip  │  │ Skip  │
└───┬───┘  └───┬───┘
    │          │
    ▼          ▼
┌───────┐  ┌───────┐
│ LOW   │  │ Report│
│ Update│  │ Only  │
└───┬───┘  └───────┘
    │          │
    └────┬─────┘
         │
         ▼
┌──────────────────┐
│  Generate Report  │ ← Send summary
└──────────────────┘

Safety Features

• Dry Run First - Always check before acting
• Risk Classification - AI-powered impact assessment
• Configurable Thresholds - Set your own risk tolerance
• Detailed Logging - Every decision is logged
• Manual Override - Always can review before updating

Troubleshooting

Updates keep being skipped

• Check risk tolerance setting
• Verify AI model is available
• Review changelog manually

False positives (too many HIGH risk)

• Lower risk tolerance
• Check AI model prompts
• Review specific change patterns

Reports not being delivered

• Verify delivery channel configuration
• Check gateway status
• Review session configuration

References

• references/risk-assessment.md → AI risk assessment methodology
• references/report-templates.md → Report format examples
• references/integration.md → Integration with cron/jobs