Smart Auto Updater

Smart Auto-Updater

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

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

Risk LevelActionHIGHSkip update, send detailed reportMEDIUMSkip update, send warning + reportLOWAuto-update, send summary

4. Report Phase

Generates readable update report Includes risk assessment Provides upgrade recommendations

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"

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"

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:
• 1. Review changelog manually
• 2. Test in staging environment
• 3. 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

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