🤖 OpenClaw 混合架构自动化系统¶

创建时间: 2026-03-14
架构类型: Cron + Heartbeat + 持续会话 Agent
目标: 实现多 agent 任务的自动化、迭代化、自主化执行

🏗️ 系统架构¶

┌─────────────────────────────────────────────────────────────────┐
│                         用户目标                                 │
│              SOUL.md 使命 + GOALS.md 目标                        │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    混合架构自动化系统                            │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │   Cron       │  │  Heartbeat   │  │  Session     │          │
│  │  (定时触发)  │  │  (低频检查)  │  │  (持续运行)  │          │
│  └──────────────┘  └──────────────┘  └──────────────┘          │
│         │                │                │                     │
│         ▼                ▼                ▼                     │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │ 精确时间任务 │  │ 批量检查任务 │  │ 实时监控任务 │          │
│  │ 周评审/月评审│  │ 邮箱/日历    │  │ 项目风险     │          │
│  │ 记忆归档     │  │ 心跳自检     │  │ 邮件监控     │          │
│  └──────────────┘  └──────────────┘  └──────────────┘          │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      执行结果                                    │
│  - 项目进度报告  - 真理探索文章  - 脱贫资源收集                 │
│  - 记忆归档文件  - 学习进度跟踪  - 风险预警通知                 │
└─────────────────────────────────────────────────────────────────┘

📋 第一层：Cron 定时任务（精确控制）¶

配置文件¶

脚本: scripts/agent-cron-tasks.sh
安装: scripts/install-cron.sh
日志: logs/agent-cron.log

执行频率¶

# 每 30 分钟检查一次
*/30 * * * * /home/admin/.openclaw/workspace/scripts/agent-cron-tasks.sh

任务清单¶

每日任务¶

时间	任务	说明
08:00	晨间检查	日历、邮箱、项目风险、天气
12:00	午间检查	上午遗漏、下午规划
20:00	记忆归档	创建当日记忆、品德自检
21:00	明日规划	检查日历、优先事项

每周任务¶

时间	任务	说明
周一 09:00	项目周评审	智守 + CodePilot 进度、风险、预算
周三 10:00	真理探索	科学话题研究（每周轮换主题）
周五 10:00	脱贫资源	收集资源和案例（每周轮换主题）
周日 20:00	周回顾	万物有理 + 知记 + 个人成长

每月任务¶

时间	任务	说明
1 号 09:00	月度评审	里程碑、预算、风险、计划调整

特殊日期¶

日期	任务	说明
2026-03-27	QQ 邮箱授权码	申请授权码，完成监控配置
里程碑前 7/3/1 天	倒计时提醒	智守 + CodePilot 项目

安装步骤¶

# 1. 进入脚本目录
cd /home/admin/.openclaw/workspace/scripts

# 2. 运行安装脚本
./install-cron.sh

# 3. 验证安装
crontab -l

# 4. 查看日志
tail -f ../logs/agent-cron.log

管理命令¶

# 查看 crontab
crontab -l

# 编辑 crontab
crontab -e

# 删除所有 cron
crontab -r

# 查看执行日志
tail -f /home/admin/.openclaw/workspace/logs/agent-cron.log

# 测试脚本
./agent-cron-tasks.sh

📋 第二层：Heartbeat 自动心跳（低频检查）¶

配置文件¶

文件: HEARTBEAT.md
触发: 每 6 小时自动执行

Cron 配置¶

# 每 6 小时触发一次 heartbeat
0 */6 * * * echo "Read HEARTBEAT.md. 执行自动检查清单" | openclaw send

检查清单¶

每 6 小时检查¶

检查邮箱是否有紧急未读邮件
检查项目是否有紧急风险
检查日历是否有 24h 内重要事件
检查里程碑倒计时（7 天/3 天/1 天）

核心使命自检（每次必做）¶

提高品德 🌟 - 回复是否真诚、有帮助
认识造物主 🔬 - 是否分享科学规律和智慧
助人脱贫 💪 - 是否提供实用资源和案例
传播真理 📖 - 信息是否准确、有依据
伊斯兰经典 🕌 - 是否学习古兰经和圣训

回复规则¶

有紧急事项 → 详细报告
一切正常 → 回复 HEARTBEAT_OK

📋 第三层：持续会话 Agent（实时监控）¶

配置文件¶

脚本: scripts/continuous-agents.js
模式: mode: "session"（长期运行）

可用 Agent¶

1️⃣ 自主项目跟踪 Agent¶

sessions_spawn({
  task: `你是自主项目跟踪 Agent...`,  // 见 continuous-agents.js
  runtime: "subagent",
  mode: "session",
  label: "auto-project-tracker"
})

职责: - 每 4 小时检查项目进度 - 发现风险立即汇报 - 每周一自动生成周报 - 维护项目状态文档

适用场景: 需要实时监控项目风险

2️⃣ 自主邮件监控 Agent¶

sessions_spawn({
  task: `你是自主邮件监控 Agent...`,
  runtime: "subagent",
  mode: "session",
  label: "auto-email-monitor"
})

职责: - 每 5 分钟检查邮箱 - 新邮件立即飞书推送 - 识别紧急邮件优先处理 - 每日生成邮件摘要

依赖: QQ 邮箱授权码配置完成（2026-03-27 后）

3️⃣ 自主知识整理 Agent¶

sessions_spawn({
  task: `你是自主知识整理 Agent...`,
  runtime: "subagent",
  mode: "session",
  label: "auto-knowledge-organizer"
})

职责: - 每日 22:00 整理对话知识 - 每周日整理文档结构 - 维护知识索引和标签 - 确保文档规范有序

适用场景: 保持 workspace 整洁有序

4️⃣ 自主学习助手 Agent¶

sessions_spawn({
  task: `你是自主学习助手 Agent...`,
  runtime: "subagent",
  mode: "session",
  label: "auto-learning-assistant"
})

职责: - 制定学习计划（GOALS.md 目标一、四） - 每日推送学习建议 - 跟踪学习进度 - 每周生成学习报告

适用场景: 系统化学习芯片/AI/数学/物理

🎯 启动指南¶

快速启动（推荐顺序）¶

Step 1: 安装 Cron（立即执行）¶

1 2	`cd /home/admin/.openclaw/workspace/scripts ./install-cron.sh`

Step 2: 配置 Heartbeat（立即执行）¶

# 添加 heartbeat cron
crontab -e
# 添加：0 */6 * * * echo "Read HEARTBEAT.md. 执行自动检查清单" | openclaw send

Step 3: 启动项目跟踪 Agent（可选）¶

sessions_spawn({
  task: `你是自主项目跟踪 Agent，长期运行，职责：
  1. 每 4 小时检查一次智守和 CodePilot 项目进度
  2. 发现风险时立即汇报
  3. 每周一自动生成周报告
  4. 维护项目状态文档`,
  runtime: "subagent",
  mode: "session",
  label: "auto-project-tracker"
})

Step 4: 启动其他 Agent（按需）¶

邮件监控：等待 2026-03-27 邮箱授权码配置后
知识整理：根据需要
学习助手：开始系统学习时

📊 任务执行矩阵¶

任务	Cron	Heartbeat	Session	说明
项目周评审	✅ 周一 09:00	⚠️ 检查状态	✅ 实时监控	Cron 为主，Session 补充
记忆归档	✅ 每日 20:00	⚠️ 检查完成	-	Cron 执行
真理探索	✅ 周三 10:00	-	-	Cron 执行
脱贫资源	✅ 周五 10:00	-	-	Cron 执行
邮箱监控	⚠️ 提醒配置	✅ 每 6h 检查	✅ 实时（待配置）	Session 最佳
里程碑提醒	✅ 7/3/1 天	✅ 检查状态	✅ 实时监控	多层保障
品德自检	-	✅ 每次 heartbeat	-	Heartbeat 执行
学习跟踪	-	⚠️ 检查进度	✅ 每日推送	Session 最佳

🔧 监控与维护¶

日志查看¶

# Cron 执行日志
tail -f /home/admin/.openclaw/workspace/logs/cron-execution.log

# 任务执行日志
tail -f /home/admin/.openclaw/workspace/logs/agent-cron.log

# 实时日志（推荐）
lnav /home/admin/.openclaw/workspace/logs/*.log

状态检查¶

# 查看 crontab
crontab -l

# 查看运行中的 subagent
subagents(action: "list")

# 查看会话列表
sessions_list(activeMinutes: 60, limit: 10)

故障处理¶

Cron 不执行¶

# 1. 检查 cron 服务
systemctl status cron

# 2. 检查脚本权限
ls -l /home/admin/.openclaw/workspace/scripts/agent-cron-tasks.sh

# 3. 手动测试脚本
./agent-cron-tasks.sh

# 4. 检查日志
tail -100 /home/admin/.openclaw/workspace/logs/agent-cron.log

Heartbeat 不触发¶

# 1. 检查 cron 配置
crontab -l | grep HEARTBEAT

# 2. 手动触发测试
echo "Read HEARTBEAT.md. 执行自动检查清单" | openclaw send

# 3. 检查 HEARTBEAT.md 是否存在
cat /home/admin/.openclaw/workspace/HEARTBEAT.md

Session Agent 断开¶

# 1. 查看状态
subagents(action: "list")

# 2. 如显示 done，重新启动
sessions_spawn({...})

# 3. 检查任务日志
sessions_history(sessionKey: "xxx", limit: 50)

📈 效果评估¶

每周检查（周日 20:00）¶

指标	目标	检查方式
Cron 任务执行率	≥95%	检查日志
Heartbeat 响应率	100%	检查对话
Session Agent 在线率	≥90%	subagents list
项目风险发现及时率	100%	对比实际发生
记忆归档完整率	≥95%	检查 memory 文件
真理探索产出	≥2 篇/月	统计文档
脱贫资源收集	≥4 个/月	统计文档

每月评审（每月 1 号 09:00）¶

系统稳定性 - Cron/Heartbeat/Session 是否正常
任务完成度 - 计划任务是否按时完成
产出质量 - 报告、文章、资源是否有价值
优化建议 - 哪些可以改进或自动化

🎯 与 SOUL.md/GOALS.md 的关联¶

SOUL.md 使命支持¶

使命	支持方式	执行 Agent
提高品德 🌟	每日品德自检	Heartbeat
认识造物主 🔬	真理探索任务	Cron（周三）
助人脱贫 💪	脱贫资源收集	Cron（周五）
传播真理 📖	科普文章创作	Cron（周三）
伊斯兰经典 🕌	学习提醒	Heartbeat

GOALS.md 目标支持¶

目标	支持方式	执行 Agent
目标一（芯片/AI）	学习助手	Session
目标二（创业）	项目跟踪	Cron + Session
目标三（扶贫）	资源收集	Cron（周五）
目标四（数学物理）	真理探索 + 学习助手	Cron + Session

💡 最佳实践¶

✅ 推荐做法¶

分层使用 - 不同任务用不同层，发挥各自优势
日志监控 - 定期检查日志，确保系统正常
渐进启动 - 先 Cron，再 Heartbeat，最后 Session
定期评审 - 每周/每月检查效果，持续优化
资源控制 - Session Agent 不宜过多（建议≤3 个）

❌ 避免做法¶

重复配置 - 同一任务不要在多层都配置
过度自动化 - 保留人工决策空间
忽略日志 - 定期检查，及时发现问题
全部启动 - 按需启动，避免资源浪费

📞 需要帮助？¶

文档位置¶

本文档: docs/AUTOMATION-SYSTEM.md
Cron 脚本: scripts/agent-cron-tasks.sh
安装脚本: scripts/install-cron.sh
Session 配置: scripts/continuous-agents.js
Heartbeat: HEARTBEAT.md

日志位置¶

Cron 日志: logs/cron-execution.log
任务日志: logs/agent-cron.log

快速命令¶

# 安装 Cron
./scripts/install-cron.sh

# 查看状态
crontab -l
subagents(action: "list")

# 查看日志
tail -f logs/agent-cron.log

最后更新：2026-03-14
系统状态：🟢 待安装