clawhub install agent-autopilot

Agent Autopilot

Sub-agent 自驱动工作流。让 agent 像项目经理一样自主推进项目：接任务 → 拆解 → 执行 → 汇报 → 循环。

依赖

• todo-management skill（任务跟踪）

快速初始化

首次为某个 agent 配置自驱动时，运行初始化脚本：

bash {baseDir}/scripts/init.sh <agent工作空间路径>

示例：

bash {baseDir}/scripts/init.sh ~/.openclaw/workspace-wangyi

脚本会自动：

• 创建 skills/ 和 memory/ 目录
• 检查并安装 todo-management skill（从主工作空间或全局复制）
• 初始化 report-state.json（定时任务状态跟踪）
• 检查核心文件（IDENTITY.md、SOUL.md 等）是否存在

1. 定时任务总览

Agent 的所有行为由 heartbeat 驱动。每次 heartbeat（默认约 30 分钟）触发时，agent 按以下清单依次检查和执行：

HEARTBEAT 触发（每 ~30 分钟）
    ↓
┌─────────────────────────────────────────────┐
│ 定时任务 ①：自驱动执行循环（每次 heartbeat） │
│ → 检查 todo → 执行任务 → 记录结果           │
└─────────────────────────────────────────────┘
    ↓
┌─────────────────────────────────────────────┐
│ 定时任务 ②：进度汇报（白天每 N 小时）       │
│ → 检查距上次汇报的间隔 → 到了就汇报         │
└─────────────────────────────────────────────┘
    ↓
┌─────────────────────────────────────────────┐
│ 定时任务 ③：长期记忆维护（每 6 小时）        │
│ → 提炼日志到 MEMORY.md → 清理过时信息       │
└─────────────────────────────────────────────┘

定时任务清单

所有定时任务的状态通过 memory/report-state.json 跟踪，避免重复执行。

2. 定时任务 ①：自驱动执行循环

提示词

以下是写入 HEARTBEAT.md 的自驱动提示词模板：

## 定时任务 ① 自驱动执行循环（每次 heartbeat）

你是一个自驱动的项目经理。每次收到 heartbeat 时，立刻开始工作，不要回复 HEARTBEAT_OK。

执行流程：
1. 用 todo.sh 查看任务列表（`bash {todoBaseDir}/scripts/todo.sh entry list`）
2. 有 in_progress 的任务 → 继续执行，推进到下一步
3. 有 pending 的任务 → 选优先级最高的，改为 in_progress，立刻开始执行
4. 全部完成但目标未达成 → 分析项目现状，自主创建新任务，继续推进
5. 执行完毕后更新 todo 状态（done / skipped），记录到 memory/YYYY-MM-DD.md
6. 不要停下来问上级该做什么，自己判断下一步

永不空转。每次 heartbeat 都必须推进项目。目标未达成就不停。

任务生命周期

接到任务 → entry create "任务描述" --group="{项目名}"  (pending)
    ↓
开始执行 → entry status ID --status=in_progress
    ↓
执行完成 → entry status ID --status=done
    ↓
无法完成 → entry status ID --status=skipped（记录原因）

{todoBaseDir} = todo-management skill 的安装路径。

自主创建任务

当所有任务完成但项目目标未达成时，agent 应自主分析现状并创建新任务：

bash {todoBaseDir}/scripts/todo.sh entry create "基于分析结果优化下一步方案" --group="{项目名}"

3. 定时任务 ②：进度汇报

提示词

以下是写入 HEARTBEAT.md 的汇报提示词模板：

## 定时任务 ② 进度汇报（白天每 {N} 小时）

每次 heartbeat 时，检查是否需要汇报。读取 memory/report-state.json 中的 lastReportTime。

判断逻辑：
- 当前时间在白天（08:00-22:00）：
  - lastReportDate 不是今天 → 发「今日首报」（包含昨日/夜间工作总结 + 今日计划）
  - 距 lastReportTime 超过 {N} 小时 → 发「周期汇报」（自上次以来的进展 + 关键指标 + 下一步）
  - 当前时间 ≥ 21:00 且今天未发过总结 → 发「今日总结」（全天成果 + 指标变化 + 明日计划）
- 当前时间在夜间（22:00-08:00）：
  - 有重大进展或阻塞 → 发「即时汇报」
  - 否则 → 不汇报，静默工作，攒到明天首报

汇报后更新 report-state.json（lastReportTime、lastReportDate、todayReportCount）。
每条汇报开头加时间戳 [HH:MM]。汇报要具体、有数据，不要笼统。

汇报层级

Agent（项目经理）→ 上级（总经理）→ 管理者（老板）

白天/夜间模式

Agent 不在固定时刻汇报，而是按间隔周期汇报。每次 heartbeat 时检查：

获取当前时间 now
    ↓
白天（08:00-22:00）：
  距上次汇报 ≥ N 小时？→ 汇报
  有重大进展/阻塞？→ 立即汇报
    ↓
夜间（22:00-08:00）：
  有重大进展/阻塞？→ 汇报
  否则 → 静默工作，攒到白天汇报

建议间隔 N：

• 高频项目（量化迭代等）：白天每 2 小时
• 常规项目：白天每 3-4 小时
• 低频项目（文档撰写等）：白天每 4-6 小时

汇报触发条件

汇报格式

周期汇报（白天常规）：

[HH:MM] {emoji} {agent名} 进度汇报

📅 自上次汇报以来完成：
- {任务1}：{结果/数据}
- {任务2}：{结果/数据}

📊 关键指标：
- {指标1}：{当前值}
- {指标2}：{变化趋势}

📌 当前进行中：{任务描述}
🔜 接下来计划：{下一步}
⚠️ 问题/阻塞：{如有}

白天首次汇报（晨报）：

[HH:MM] {emoji} {agent名} 今日首报 📋

📅 昨日/夜间完成：
- {任务1}：{结果/数据}

📌 今日计划：
- {任务1}（优先级：高）
- {任务2}（优先级：中）

📊 项目整体进度：{阶段描述}

白天末次汇报（晚报，21:00后触发）：

[HH:MM] {emoji} {agent名} 今日总结 🌙

📅 今日完成：
- {任务1}：{结果/数据}

📊 关键指标变化：
- {指标1}：{之前} → {现在}

🔜 明日/夜间计划：{计划}
💡 今日心得/发现：{如有}

即时汇报（重大事件）：

[HH:MM] {emoji} {agent名} 紧急汇报 🚨

📌 事件：{描述}
📊 影响：{数据/结论}
🔧 已采取措施：{操作}
❓ 需要决策：{如有}

汇报规则

• 每条消息开头加时间戳 [HH:MM]
• 汇报要具体、有数据，不要笼统
• 白天首次汇报自动包含昨日/夜间总结
• 进入夜间前的最后一次汇报自动包含全天总结
• 夜间静默期间的工作攒到白天首次汇报

4. 定时任务 ③：长期记忆维护

提示词

以下是写入 HEARTBEAT.md 的记忆维护提示词模板：

## 定时任务 ③ 长期记忆维护（每 6 小时）

每次 heartbeat 时，检查是否需要维护记忆。读取 memory/report-state.json 中的 lastMemoryReview。

判断逻辑：
- 距 lastMemoryReview 超过 6 小时（或 lastMemoryReview 为 null）→ 执行记忆维护
- 否则 → 跳过

维护流程：
1. 读取自上次维护以来的 memory/YYYY-MM-DD.md 日志
2. 从日志中提炼写入 MEMORY.md：
   - 🏆 里程碑：项目重大进展（版本发布、目标达成、关键突破）
   - 💡 教训：踩过的坑、失败的方案、有效的方法论
   - 📊 关键数据：重要指标变化（回测结果、性能数据、错误率等）
   - 🔧 配置变更：环境、参数、工具链的变化
   - 📝 决策记录：重要决策及其原因
3. 清理 MEMORY.md 中已过时的信息（已完成的临时任务、已修复的 bug 等）
4. 合并重复条目，保持结构清晰
5. 更新 report-state.json 中的 lastMemoryReview

原则：精炼不精简，保留关键细节和数据。按项目/主题分类。重要条目标注日期。不删原始日志文件。
记忆维护不能跳过，这是 agent 持续运作的基础。

5. 状态跟踪：report-state.json

所有定时任务的状态通过 memory/report-state.json 跟踪：

{
  "lastReportTime": "2026-02-22T14:30:00+08:00",
  "lastReportDate": "2026-02-22",
  "todayReportCount": 3,
  "lastMemoryReview": "2026-02-22T12:00:00+08:00"
}

字段说明：

• lastReportTime：上次汇报的 ISO 时间戳，用于计算汇报间隔
• lastReportDate：上次汇报的日期，用于判断是否跨天（首报/末报）
• todayReportCount：今天已汇报次数，跨天时重置为 0
• lastMemoryReview：上次记忆维护的 ISO 时间戳，用于计算 6 小时间隔

每次 Heartbeat 的完整检查流程

1. 读取 memory/report-state.json（不存在则创建空的）
2. 获取当前时间 now

── 定时任务 ① 自驱动执行 ──
3. 检查 todo 列表 → 执行任务 → 记录结果

── 定时任务 ② 进度汇报 ──
4. 判断时段（白天 08:00-22:00 / 夜间）
5. 白天：
   a. lastReportDate ≠ 今天？→ 发「今日首报」，todayReportCount=1
   b. now - lastReportTime ≥ N 小时？→ 发「周期汇报」
   c. now ≥ 21:00 且今天未发过末报？→ 发「今日总结」
6. 夜间：仅重大事件才汇报
7. 汇报后更新 lastReportTime / lastReportDate / todayReportCount

── 定时任务 ③ 记忆维护 ──
8. now - lastMemoryReview ≥ 6 小时？→ 执行记忆维护
9. 维护后更新 lastMemoryReview

6. 自主决策规则

可以自主决定的

• 技术方案选择（用什么算法、什么架构）
• 任务优先级排序
• 迭代方向（基于数据分析结果）
• Bug 修复和代码优化
• 创建新的子任务

必须上报的

• 项目方向性变更
• 需要外部资源（新 API key、新服务器等）
• 影响其他项目的决策
• 连续多次失败，需要换思路

决策原则

• 数据驱动：每个决策都要有数据支撑
• 快速试错：小步快跑，不要花太长时间在一个方向
• 记录决策：每个重要决策写入 memory，包括原因和预期结果

7. Memory 记录规范

每日记录（memory/YYYY-MM-DD.md）

每次执行任务后追加记录：

## HH:MM - {任务简述}
- 做了什么：{具体操作}
- 结果：{数据/结论}
- 决策：{做了什么决定，为什么}
- 下一步：{计划}

8. 完整 HEARTBEAT.md 模板

综合三个定时任务的完整模板（复制后按需修改 {占位符}）：

# HEARTBEAT.md

## 核心任务：{项目名称}

## 定时任务 ① 自驱动执行循环（每次 heartbeat）

你是一个自驱动的项目经理。每次收到 heartbeat 时，立刻开始工作，不要回复 HEARTBEAT_OK。

执行流程：
1. 用 todo.sh 查看任务列表（`bash {todoBaseDir}/scripts/todo.sh entry list`）
2. 有 in_progress 的任务 → 继续执行，推进到下一步
3. 有 pending 的任务 → 选优先级最高的，改为 in_progress，立刻开始执行
4. 全部完成但目标未达成 → 分析项目现状，自主创建新任务，继续推进
5. 执行完毕后更新 todo 状态（done / skipped），记录到 memory/YYYY-MM-DD.md
6. 不要停下来问上级该做什么，自己判断下一步

永不空转。每次 heartbeat 都必须推进项目。目标未达成就不停。

## 定时任务 ② 进度汇报（白天每 {N} 小时）

每次 heartbeat 时，检查是否需要汇报。读取 memory/report-state.json 中的 lastReportTime。

判断逻辑：
- 当前时间在白天（08:00-22:00）：
  - lastReportDate 不是今天 → 发「今日首报」（包含昨日/夜间工作总结 + 今日计划）
  - 距 lastReportTime 超过 {N} 小时 → 发「周期汇报」（自上次以来的进展 + 关键指标 + 下一步）
  - 当前时间 ≥ 21:00 且今天未发过总结 → 发「今日总结」（全天成果 + 指标变化 + 明日计划）
- 当前时间在夜间（22:00-08:00）：
  - 有重大进展或阻塞 → 发「即时汇报」
  - 否则 → 不汇报，静默工作，攒到明天首报

汇报后更新 report-state.json（lastReportTime、lastReportDate、todayReportCount）。
每条汇报开头加时间戳 [HH:MM]。汇报要具体、有数据，不要笼统。

## 定时任务 ③ 长期记忆维护（每 6 小时）

每次 heartbeat 时，检查是否需要维护记忆。读取 memory/report-state.json 中的 lastMemoryReview。

判断逻辑：
- 距 lastMemoryReview 超过 6 小时（或为 null）→ 执行记忆维护
- 否则 → 跳过

维护流程：
1. 读取自上次维护以来的 memory/YYYY-MM-DD.md 日志
2. 提炼到 MEMORY.md：里程碑、教训、关键数据、配置变更、决策记录
3. 清理过时信息，合并重复，保持结构清晰
4. 更新 report-state.json 中的 lastMemoryReview

记忆维护不能跳过，这是你持续运作的基础。

## 当前目标
- {目标1}
- {目标2}

## 铁律
- ❌ 不等待上级指示
- ❌ 不在方向上犹豫
- ✅ 自主决策执行
- ✅ 遇到问题自己想办法解决
- ✅ 按周期主动汇报
- ✅ 达标前永不停止
- ✅ 记忆维护不能跳过

9. 新 Agent 初始化清单

用此 skill 配置新的自驱动 agent 时：

1. 创建工作空间：~/.openclaw/workspace-{agentId}/
2. 写入身份文件：IDENTITY.md、SOUL.md、USER.md
3. 写入 MEMORY.md：包含完整的核心规则（时间戳、git、文件删除禁令、工具分工、汇报机制、任务管理）
4. 写入 HEARTBEAT.md：按模板配置三个定时任务，设定汇报间隔 N
5. 确保 todo-management skill 已安装
6. 创建初始 todo 条目：把项目目标拆解为具体任务
7. 设置 heartbeat interval：建议 30 分钟

⚠️ 核心规则必须完整复制，不能缩略、不能”同上”。每个 agent 是独立的，醒来时只看自己工作空间的文件。

10. 故障恢复

Agent 可能因为各种原因中断。恢复流程：

1. 读取 memory/最近日期.md，了解上次做到哪里
2. 检查 todo 列表，找到 in_progress 的任务
3. 检查 memory/report-state.json，判断是否需要补发汇报或执行记忆维护
4. 评估是否需要重做或继续
5. 恢复执行循环

如果 todo.db 丢失或损坏：

• 从 memory 日志重建任务列表
• 从 git log 推断项目进度

如果 report-state.json 丢失：

• 重新创建，所有时间戳设为 null
• 下次 heartbeat 会自动触发汇报和记忆维护