适用场景

当用户希望 OpenClaw 及已安装技能保持自动更新时使用。本技能会配置一个真实的 openclaw cron add 定时任务，在 ~/auto-update/ 下维护一个轻量级控制目录，记录哪些技能应启用自动更新，更新前先备份关键文件，技能变更前审查迁移风险，并在每次运行后汇总变更内容。

架构设计

状态数据存储于 ~/auto-update/ 目录中。若该目录不存在，请先执行 setup.md。目录结构详见 memory-template.md。

~/auto-update/
├── memory.md        # 全局默认值、启用状态与摘要偏好设置
├── openclaw.md      # OpenClaw 更新模式、通道、备份范围、功能审查偏好
├── skills.md        # 各技能策略、已安装版本、备份状态、迁移状态
├── schedule.md      # 已批准的执行时间、时区与调度器所有者
├── backups.md       # 最新 OpenClaw 与技能备份清单
├── migrations.md    # 待处理的迁移检查项及用户决策记录
└── run-log.md       # 近期运行记录、版本信息与执行结果

快速查阅索引

快速入门

默认模型非常简洁：

• 创建一个 OpenClaw cron 定时任务
• 让该定时任务读取 ~/auto-update/*.md 中的配置文件
• 仅更新 OpenClaw 及被允许的技能
• 先备份，再生成摘要

用户应能识别的关键命令如下：

openclaw update status --json
openclaw update --json
clawhub update --all --dry-run
clawhub update --all

示例：每日定时任务

openclaw cron add 
  --name "Auto-Update" 
  --cron "0 4 * * *" 
  --tz "Europe/Madrid" 
  --session isolated 
  --wake now 
  --announce 
  --message "执行自动更新流程。在变更任何内容前，请先阅读 ~/auto-update/memory.md、~/auto-update/openclaw.md、~/auto-update/skills.md 和 ~/auto-update/migrations.md。然后：1) 检查 OpenClaw 更新状态，仅当 openclaw.md 中 mode 设置为 auto 时才应用 OpenClaw 更新；2) 检查技能更新项；3) 备份已批准的 OpenClaw 文件及所有允许变更的技能；4) 跳过标记为 no、pending 或 ask-first 的技能；5) 仅应用被允许的更新；6) 验证基本健康状态；7) 写入 backups.md 和 run-log.md；8) 报告已更新、未变更、已跳过及失败的项目。"

更安全的变体（预通知模式）：

openclaw cron add 
  --name "Auto-Update (Notify First)" 
  --cron "0 4 * * *" 
  --tz "Europe/Madrid" 
  --session isolated 
  --wake now 
  --announce 
  --message "执行自动更新审查流程。请先阅读 ~/auto-update/memory.md、~/auto-update/openclaw.md、~/auto-update/skills.md 和 ~/auto-update/migrations.md。检查 OpenClaw 更新项并运行 clawhub update --all --dry-run。对于处于 notify、no、pending 或 ask-first 模式的任意项目，均不应用实际变更。报告将发生哪些变更、哪些被阻塞、以及将创建哪些备份。"

每次运行如何决策

每次 cron 运行均遵循相同流程契约：

1. 读取 ~/auto-update/memory.md
2. 读取 ~/auto-update/openclaw.md
3. 读取 ~/auto-update/skills.md
4. 读取 ~/auto-update/migrations.md
5. 执行 openclaw update status --json 检查当前状态
6. 执行 clawhub update --all --dry-run 预览技能更新
7. 备份所有允许更新的目标
8. 仅当 core mode 为 auto 时，执行 openclaw update --json
9. 仅对允许更新的技能执行更新操作
10. 汇总已更新、未变更、已跳过及失败的项目

初始模式选项

若用户表示“直接处理即可”，则默认采用“即时每日更新”模式，但仍保留迁移问题提示功能。

核心规则

1. 自动更新 = 真实的定时更新

• 核心承诺是真正执行 OpenClaw 和技能更新，而非仅记录策略说明。
• 默认机制是使用 openclaw cron add 创建的 OpenClaw cron 定时任务。
• 该定时任务必须在决定更新内容前，读取 ~/auto-update/ 下的控制文件。
• 同一套定时流程需统一完成检查、备份、更新、验证与报告，覆盖 OpenClaw 和技能两方面。
• 若用户确认每日调度计划，则必须创建或更新确切的调度器条目以实现每日执行，不可仅将周期写入 schedule.md 作为备注。

2. 为新技能学习默认策略

• 首次询问用户：新技能是否默认启用“全量自动更新”或“全手动管理”。
• 每次安装新技能时，需确认两个问题：是否需要该技能的简要说明；该技能是否应启用自动更新或保持手动。
• 将用户回答记录至 skills.md，确保后续会话无需猜测。

3. 更新 OpenClaw 或技能前必须备份

• OpenClaw 更新前，快照用户最关心的定制化文件与配置。
• 每个技能更新前，保存当前已安装的技能目录及其版本标识。
• 每次备份均需记录至 backups.md，并在运行后摘要中引用。

4. 技能更新前须审查迁移风险

• 在覆盖安装前，比对当前已安装技能状态与新版本差异。
• 若存在路径、目录、AGENTS、TOOLS、SOUL、setup 或 state-storage 的变更，应在 migrations.md 中标记。
• 若迁移影响不明确，或有状态化文件可能移动，应在应用变更或首次使用新版本前向用户确认。

5. 尊重实际的 OpenClaw 更新路径

• 采用官方文档指定的 OpenClaw 更新路径：定时任务应先调用 openclaw update status --json 检查，获准后再于定时上下文中执行 openclaw update --json。
• auto、notify 和 manual 等模式定义于 openclaw.md；定时任务消息须每次运行均遵守其中设定。
• OpenClaw 更新后，执行常规健康检查：doctor、按需重启、健康状态验证。
• 若用户仅需核心自动化（即仅 OpenClaw 更新），定时任务应显式跳过技能更新步骤，而非移除共用控制流。

6. 将发布说明转化为实用建议

• OpenClaw 更新后，用通俗语言总结变更要点。
• 可选提供后续审查环节，将新增功能或变更映射至用户的实际工作流。
• 切勿因某条发布说明看似诱人就自动应用工作流变更。

7. 始终保障用户控制权

• 未经用户明确批准，禁止自动迁移状态、移动目录、删除备份或重写工作区行为文件。
• 禁止静默添加调度器条目或工作区提醒片段；须先向用户展示拟添加的确切行内容。
• 禁止修改本技能自身的 SKILL.md 文件。
• 心跳机制（heartbeat）不得作为精确每日更新的主要手段；仅可用于补充场景：安装时提醒、迁移提醒、运行失败复盘、或更新后建议。

常见陷阱

作用范围

本技能仅做以下事项：

• 配置真实的 OpenClaw 与技能更新流程
• 在 ~/auto-update/ 中持久化本地默认值与各技能决策
• 为新技能安装提供可选的安装时提醒集成
• 在更新前后创建备份、迁移说明与运行摘要

本技能绝不会：

• 未经批准自动迁移用户状态或目录结构
• 在用户选择 all-out 模式时强制所有技能启用自动更新
• 未经可见方案或长期授权，擅自编辑 AGENTS、cron、launchd、Task Scheduler 或 ~/.openclaw/openclaw.json
• 在本地记忆文件中存储密钥（secrets）
• 修改自身技能文件

数据存储

本地状态数据存于 ~/auto-update/ 目录中：

• memory.md：用于持久化默认值与启用说明
• openclaw.md：定义核心更新器模式、通道、备份范围及功能审查偏好
• skills.md：记录各技能的自动更新策略与已安装版本历史
• schedule.md：记录时区、执行周期与调度器归属
• backups.md：记录备份路径与保留策略
• migrations.md：记录待处理的迁移检查项与用户决策
• run-log.md：精简记录运行历史与结果

外部端点

除此之外，不向任何外部服务发送其他数据。

安全与隐私

• 本技能将本地策略与日志存储于 ~/auto-update/。
• 在必要时，可读取 .clawhub/lock.json、~/.openclaw/openclaw.json 及工作区行为文件，以支持经批准的更新操作。
• 更新前会执行文件备份，但绝不在自身本地账本中存储密钥（secrets）。
• 调度器变更、工作区集成、OpenClaw 配置编辑及高风险迁移操作，均需用户显式批准；除非用户已预先批准该类操作。
• 绝不修改自身 SKILL.md 文件。

信任声明

使用本技能时，更新流量可能访问 OpenClaw 更新源、ClawHub、npm 或用户指定的 git 远程仓库。仅当您信任这些服务处理更新检查与软件包下载时，方可安装本技能。

相关技能

若用户确认，可通过 clawhub install 安装以下技能：

• skill-update —— 更深入地审查高风险技能差异、迁移方案与回滚选项
• backups —— 在默认更新器快照基础上，强化备份与恢复实践
• heartbeat —— 将精确时间点更新任务与自适应后续检查相结合
• self-improving —— 学习重复出现的更新偏好、故障模式及工作流优化机会

反馈

• 若本技能有用：clawhub star auto-update
• 保持更新：clawhub sync