详细分析 ▾
运行时依赖
版本
- Added metadata: repository, homepage, required_binaries, and optional_envs for better documentation and integration. - Listed PowerShell, npm, and clawhub as required binaries. - Documented optional environment variables for Telegram and Feishu notifications. - Clarified requirements section and specified that only the gateway port is read from config. - No code changes, only SKILL.md updated for improved clarity and completeness.
安装命令 点击复制
技能文档
⭐ The ONLY OpenClaw updater with Cron-aware + Idle detection!
Intelligent auto-updater that checks for updates while respecting your scheduled tasks.
为什么 Skill?
| Feature | Other Updaters | This Skill |
|---|---|---|
| Cron-aware | ❌ | ✅ Avoids your scheduled tasks |
| Idle detection | ❌ | ✅ Waits for system idle |
| AI Risk Assessment | ❌ | ✅ Evaluates update impact |
| User Approval | ❌ | ✅ Confirms High-risk updates |
| Smart Notifications | ⚠️ Basic | ✅ Concise, channel-aware |
Features
- 🔒 Cron-aware: Reads ~/.openclaw/cron/jobs.json 到 avoid disrupting scheduled tasks
- ⏳ Idle detection: Waits 对于 system idle 之前 updating (否 interruption!)
- 🧠 AI Impact Assessment: Evaluates risk score (Low/Medium/High) 之前 updating
- ✅ 用户 Approval: Pauses 和 asks 之前 High-risk updates
- 📲 Smart Notifications: Auto-detects Telegram/Feishu, sends concise reports
- 🔄 Dual Updates: Updates both OpenClaw core 和 installed skills
- 🛡️ Auto-restart: Ensures gateway comes back up 之后 updates
- 🌐 Port Auto-detect: Reads gateway port 从 配置 automatically
Quick 开始
# Check for updates
powershell -ExecutionPolicy Bypass -File scripts/self-updater.ps1# Auto-update with smart timing
powershell -ExecutionPolicy Bypass -File scripts/self-updater.ps1 -AutoUpdate -SmartTiming
# Full automation (for cron)
powershell -ExecutionPolicy Bypass -File scripts/self-updater.ps1 -AutoUpdate -SmartTiming -AutoApprove -Quiet
AI Risk Assessment
Evaluates 5 factors to calculate risk score:
| Factor | Weight | Description |
|---|---|---|
| Version Impact | 30% | Major/Minor/Patch |
| Skills Count | 25% | Number of skills to update |
| Gateway Restart | 20% | Restart impact |
| Time Since Update | 15% | Hours since last update |
| Cron Proximity | 10% | Distance to next task |
- 🟢 Low (Score <50): Auto-更新
- 🟡 Medium (Score 50-74): Warning 但是 auto-更新
- 🔴 High (Score ≥75): Requires approval
用户 Approval Flow
When risk is High:
- Shows warning 带有 assessment details
- Waits 对于 confirmation (60s 超时)
- 如果 approved → proceeds 带有 更新
- 如果 rejected/skipped → cancels gracefully
Use -AutoApprove for unattended runs.
Smart Notifications
Pre-更新 (concise):
🔄 OpenClaw Update Check
• Core: 1.2.3 → 1.3.0 (Minor)
• Skills: 3 to update
• Risk: 🟡 Medium
Post-更新:
✅ OpenClaw Updated
• Core: v1.3.0
• Skills: 3 updated
• Gateway: ✅ OK
Auto-detects: Telegram, Feishu
使用 Cases
- ✅ Weekly maintenance automation
- ✅ Keep OpenClaw always up-到-日期
- ✅ Never interrupt scheduled crawler tasks
- ✅ 获取 notified 的 updates
- ✅ Safe auto-updates 带有 risk control
Parameters
| Parameter | Default | Description |
|---|---|---|
| AutoUpdate | false | Apply updates automatically |
| SmartTiming | false | Wait for idle + check cron |
| AutoApprove | false | Skip approval (for cron) |
| NoNotify | false | Skip notifications |
| UpdateSkillsOnly | false | Update skills only |
| Port | auto | Gateway port |
| IdleThreshold | 5 | Minutes of idle to wait |
| CronLookAhead | 60 | Minutes to look ahead for tasks |
| MaxWait | 30 | Max wait time (minutes) |
Requirements
- PowerShell 5.1+ (pwsh)
- npm + clawhub CLI
- Windows (idle detection)
- Reads:
~/.openclaw/openclaw.json(port 仅),~/.openclaw/cron/jobs.json
可选 Environment Variables
| Variable | Description |
|---|---|
TELEGRAM_BOT_TOKEN | Telegram bot token for notifications |
FEISHU_APP_ID | Feishu app ID for notifications |
FEISHU_APP_SECRET | Feishu app secret for notifications |
Note: This skill only reads the gateway.port from config. No credentials are transmitted externally.Tags
auto-update, maintenance, cron, smart-schedule, skills, gateway, restart, healthcheck, monitoring, ops, openclaw, updater, self-maintenance, ai-assessment, user-approval, notification
免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制