Auto-Updater Pro

增强型自动更新器，支持详细日志记录、错失运行恢复及 Gateway 重启保护。

版本：1.1.0（更新于 2026-02-22）

新增特性：

• ✅ 每一步均记录详细日志（防止 Gateway 重启导致状态丢失）
• ✅ 错失运行恢复（若 Gateway 离线，将自动补执行）
• ✅ 更新完成后延迟 30 秒（避免中断正在进行的操作）
• ✅ 支持邮件报告（相比聊天消息更少干扰）
• ✅ 更完善的错误处理与重试逻辑

说明：这是原始 auto-updater 技能的增强版本，具备生产环境就绪特性。

功能说明

该技能会设置一个每日定时任务（cron job），用于：

1. 更新 Clawdbot 自身（通过 clawdbot doctor 或包管理器）
2. 更新所有已安装的技能（通过 clawdhub update --all）
3. 向您发送本次更新内容的摘要报告
4. 新增：每一步均写入日志，防止 Gateway 重启导致状态丢失
5. 新增：若错过预定执行时间，则自动补执行

配置方法

快速开始

请 Clawdbot 设置自动更新器：

为您的个人账户及所有技能设置每日自动更新。

或手动添加定时任务：

clawdbot cron add 
  --name "Daily Auto-Update" 
  --cron "0 4 * * *" 
  --tz "America/Los_Angeles" 
  --session isolated 
  --wake now 
  --deliver 
  --message "运行每日自动更新：检查 Clawdbot 更新并更新所有技能，报告更新内容。"

推荐配置（v1.1.0+）

生产环境中，请在定时任务中加入以下配置项：

{
  "schedule": {
    "expr": "0 4 * * *",
    "kind": "cron",
    "tz": "Asia/Shanghai"
  },
  "missedRunPolicy": "run-immediately",
  "payload": {
    "kind": "agentTurn",
    "message": "...",
    "timeoutSeconds": 600
  }
}

关键配置项：

• missedRunPolicy: "run-immediately" — 若 Gateway 在预定时间离线，则立即补执行
• timeoutSeconds: 600 — 允许更新操作最多耗时 10 分钟
• tz: "Asia/Shanghai" — 请根据您的实际时区进行设置

配置选项

更新机制说明

Clawdbot 自身更新

适用于 npm/pnpm/bun 安装方式：

npm update -g clawdbot@latest
# 或：pnpm update -g clawdbot@latest
# 或：bun update -g clawdbot@latest

适用于 源码安装方式（git checkout）：

clawdbot update

每次更新后务必运行 clawdbot doctor 以应用数据库迁移等变更。

技能更新

clawdhub update --all

该命令将比对本地已安装技能与技能注册中心（registry）中的最新版本，并自动升级所有存在新版本的技能。

更新摘要格式

更新完成后，您将收到类似如下格式的消息：

🔄 每日自动更新完成

**Clawdbot**：已升级至 v2026.1.10（原为 v2026.1.9）

**已更新技能（3 个）**：
- prd: 2.0.3 → 2.0.4
- browser: 1.2.0 → 1.2.1  
- nano-banana-pro: 3.1.0 → 3.1.2

**无需更新技能（5 个）**：
gemini, sag, things-mac, himalaya, peekaboo

未发现异常。

详细日志记录（v1.1.0+）

为防止 Gateway 重启期间发生状态丢失，整个更新流程对每个步骤均进行日志记录：

日志文件位置

~/.openclaw/workspace/memory/openclaw-update-YYYY-MM-DD.md

日志格式

# OpenClaw 更新日志 YYYY-MM-DD

## 更新前
- 开始时间：HH:mm:ss
- 当前版本：x.x.x
- 最新版本：x.x.x

## 更新中
- 更新开始：HH:mm:ss
- 更新命令：...
- 更新完成：HH:mm:ss
- 验证版本：x.x.x

## 更新后
- 状态：已是最新 / 已更新 / 更新失败
- 报告发送：成功 / 失败
- 完成时间：HH:mm:ss

## 更新内容
（从 CHANGELOG 或 npm 获取）

六阶段更新流程

第一阶段：准备

• 记录起始时间
• 检查当前版本
• 立即写入日志文件

第二阶段：检查更新

• 查询最新版本（调用 npm view）
• 追加日志条目
• 比对版本号

第三阶段：执行更新

• 记录更新起始时间
• 执行 openclaw update run 或 npm install -g openclaw@latest
• 立即记录更新完成状态
• 验证新版本是否生效

第四阶段：持久化状态

• 将完整结果追加至日志文件
• 等待 3 秒确保磁盘同步完成

第五阶段：发送报告

• 发送邮件/聊天形式的报告
• 记录报告投递状态

第六阶段：延迟重启（关键！）

• 等待 30 秒后再执行任何 Gateway 重启操作
• 确保 npm 进程完全结束
• 防止状态丢失

手动命令

仅检查更新但不实际执行：

clawdhub update --all --dry-run

查看当前已安装技能及其版本：

clawdhub list

查看 Clawdbot 当前版本：

clawdbot --version

故障排查

更新任务未执行

1. 确认定时任务已启用：检查配置中 cron.enabled 是否为 true
2. 确认 Gateway 持续运行中
3. 检查定时任务是否存在：clawdbot cron list
4. 确认是否设置了错失运行策略：missedRunPolicy: "run-immediately"

更新失败

若更新失败，摘要报告中将包含具体错误信息。常见修复方式：

• 权限错误：确保 Gateway 运行用户对技能目录具有写入权限
• 网络错误：检查网络连通性
• 包冲突：运行 clawdbot doctor 进行诊断
• Gateway 重启中断更新：检查日志文件确认是否部分完成

更新过程中 Gateway 重启

若更新过程（尤其是 npm 安装阶段）中 Gateway 发生重启：

1. 检查日志文件：~/.openclaw/workspace/memory/openclaw-update-*.md
2. 验证版本：openclaw --version
3. 如需可手动发送报告（日志文件中已包含全部信息）

禁用自动更新

移除定时任务：

clawdbot cron remove "Daily Auto-Update"

或在配置中临时禁用：

{
  "cron": {
    "enabled": false
  }
}

最佳实践

1. 在低活跃时段调度

选择您不太可能使用系统的时段：

"expr": "0 4 * * *"  // 凌晨 4:00

2. 启用错失运行恢复

避免因 Gateway 离线而遗漏更新：

"missedRunPolicy": "run-immediately"

3. 使用邮件发送报告

相较聊天消息更少干扰：

• 配置 email-163-com 或其他邮件类技能
• 发送纯文本格式报告
• 报告中应包含日志文件路径

4. 全面记录日志

务必在发送报告前完成日志写入：

• 防止状态丢失
• 便于问题调试
• 提供审计追踪能力

5. 更新后等待再重启

在任何 Gateway 重启前增加 30 秒延迟：

sleep 30

相关资源

• Clawdbot 更新指南
• ClawdHub CLI 文档
• 定时任务（Cron Jobs）
• 更新日志（Change Log）

版本历史

v1.1.0（2026-02-22）

改进项：

• ✅ 新增每一步详细日志记录
• ✅ 新增错失运行恢复策略
• ✅ 新增更新后 30 秒延迟机制
• ✅ 新增邮件报告支持
• ✅ 改进错误处理逻辑

缺陷修复：

• 🐛 修复 Gateway 重启导致的状态丢失问题
• 🐛 修复错失预定执行的问题
• 🐛 修复报告投递失败问题

v1.0.0（2026-01-13）

• ✅ 初始发布
• ✅ 基础每日更新检查功能
• ✅ 简单摘要报告格式

发布日期：2026-02-22
维护团队：OpenClaw Team
许可证：MIT