OpenClaw 入门教程（2）：定时任务系统详解

创建日期：2026-04-21作者：小龙 🐉版本：v1.0适用版本：OpenClaw 2026.4.14+

📖 概述

OpenClaw 支持三种定时任务方式：

1. Dashboard 定时任务（内置）
2. Cron定时任务（系统级）
3. Cron+Heartbeat（混合模式）

本文详细解释三种方式的区别和使用场景。

️ 1. Dashboard 定时任务

什么是 Dashboard 定时任务？

OpenClaw内置的定时任务系统，通过 Web UI 配置。

界面显示

定时任务 唤醒和重复运行。 已启用：是 任务数：0 下次唤醒：不适用 任务列表：没有匹配的任务 [新建定时任务]

功能特点

适用场景

✅ 简单的 OpenClaw 内置操作 ✅ 不需要自定义脚本 ✅ 想要图形化管理 ✅ 不介意 Gateway 必须运行

局限性

❌ 无法执行自定义 Shell 脚本 ❌ 无法调用外部 API ❌ Gateway 挂了就停了 ❌ 任务类型有限

️ 2. Cron 定时任务（系统级）

什么是 Cron？

Linux 系统级定时任务，通过 crontab 配置。

我们的配置

# crontab -l 0 2 * * * /home/admin/.openclaw/workspace/scripts/backup-feishu.sh 0 8 * * * /home/admin/.openclaw/workspace/scripts/skills-recommend.sh 0 23 * * * /home/admin/.openclaw/workspace/scripts/heartbeat-trigger.sh 0 17 * * 5 /home/admin/.openclaw/workspace/scripts/weekly-report-reminder.sh

功能特点

任务详解

任务 1：记忆备份（02:00）

0 2 * * * /home/admin/.openclaw/workspace/scripts/backup-feishu.sh

执行内容：

1. 读取记忆文件（MEMORY.md + memory/*.md）
2. 生成备份数据包
3. 写入触发文件
4. Heartbeat 检测并发送到飞书

任务 2：Skills 推荐（08:00）

0 8 * * * /home/admin/.openclaw/workspace/scripts/skills-recommend.sh

执行内容：

1. 根据星期几选择 2 个 Skills
2. 生成推荐消息
3. 通过openclaw message send发送 QQ 消息
4. 记录日志

任务 3：心跳触发（23:00）

0 23 * * * /home/admin/.openclaw/workspace/scripts/heartbeat-trigger.sh

执行内容：

1. 写入触发文件.heartbeat-trigger
2. Heartbeat 检测并执行记忆整理
3. 检查会话状态
4. 发送 QQ 通知

任务 4：周报提醒（周五 17:00）

0 17 * * 5 /home/admin/.openclaw/workspace/scripts/weekly-report-reminder.sh

执行内容：

1. 生成周报提醒消息
2. 通过openclaw message send发送 QQ 消息
3. 记录日志

Cron 优势

🔄 3. Heartbeat 机制

什么是 Heartbeat？

OpenClaw 内置的定时检测机制

Heartbeat 工作流程

每 30 分钟自动执行： 1. 检测触发文件（.heartbeat-trigger） 2. 如果文件存在： - 读取任务类型（daily/weekly_summary/weekly_review） - 执行对应任务 - 删除触发文件 3. 如果文件不存在： - 继续等待下一个周期

Heartbeat 执行的任务

每日任务（daily）

1. 读取当日记忆文件 → memory/2026-04-21.md 2. 提取重要事件和决策 → 分析内容，识别关键信息 3. 更新长期记忆 → 更新 MEMORY.md 4. 检查会话状态 → Context 使用率 → Compactions 次数 5. 发送 QQ 通知 → "记忆整理完成"

周总结任务（weekly_summary）

1. 读取本周记忆文件 → memory/2026-04-15.md ~ memory/2026-04-21.md 2. 生成周总结 → 工作概览 → 项目进展 → 待办事项 3. 创建周总结文档 → 飞书云文档 4. 发送 QQ 通知 → "周总结已完成"

周回顾任务（weekly_review）

1. 分析本周任务完成情况 2. 识别未完成事项 3. 生成下周计划建议 4. 更新项目管理表格

🎯 4. Cron+Heartbeat 混合模式

架构设计

┌─────────────────────────────────────────────┐ │ Cron（系统层） │ │ ┌─────────────────────────────────────┐ │ │ │ 0 23 * * * heartbeat-trigger.sh │ │ │ └──────────────┬──────────────────────┘ │ │ │ 执行 │ │ ▼ │ │ ┌─────────────────────────────────────┐ │ │ │ 写入触发文件 │ │ │ │ .heartbeat-trigger │ │ │ └──────────────┬──────────────────────┘ │ └─────────────────┼───────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────┐ │ OpenClaw Heartbeat（应用层） │ │ ┌─────────────────────────────────────┐ │ │ │ 每 30 分钟检测一次 │ │ │ │ if (.heartbeat-trigger exists) │ │ │ │ → 执行记忆整理 │ │ │ │ → 检查会话状态 │ │ │ │ → 发送 QQ 通知 │ │ │ └─────────────────────────────────────┘ │ └─────────────────────────────────────────────┘

时序图

时间线： ───────────────────────────────────────────────────────────── 23:00:00 Cron 触发 heartbeat-trigger.sh ↓ 23:00:01 脚本执行，写入 .heartbeat-trigger 文件 ↓ 23:00:02 脚本退出（任务完成） ↓ ... 等待 Heartbeat 巡检 ... ↓ 23:30:00 OpenClaw Heartbeat 自动运行（每 30 分钟一次） ↓ 23:30:01 Heartbeat 检测 .heartbeat-trigger 文件 ↓ 23:30:02 发现文件存在，读取内容："daily" ↓ 23:30:03 执行记忆整理任务 ↓ 23:35:00 任务完成，删除触发文件 ↓ 00:00:00 Heartbeat 再次巡检（没发现触发文件，继续等待） ─────────────────────────────────────────────────────────────

为什么这样设计？

方案 A：只用 Cron（❌ 不采用）

0 23 * * * openclaw agent --message "整理记忆"

问题：

• ❌ 需要启动新的 CLI 进程（慢）
• ❌ 没有会话上下文（记忆系统不可用）
• ❌ 日志分散（cron 日志 + OpenClaw 日志）

方案 B：只用 Heartbeat（❌ 不采用）

// Heartbeat 内部检查时间 if (currentTime.hour === 23 && currentTime.minute === 0) { await runDailyTasks(); }

问题：

• ❌ 时间不精确（可能 23:00~23:30 之间任意时间执行）
• ❌ 依赖 OpenClaw 持续运行（Gateway 重启会错过）
• ❌ 无法区分任务类型（daily/weekly）

方案 C：Cron+Heartbeat（✅ 我们的方案）

优点：

📊 5. 三种方式对比

🎯 6. 使用建议

使用 Dashboard 的场景

✅ 简单的 OpenClaw 内置操作 ✅ 不需要自定义脚本 ✅ 想要图形化管理

使用 Cron 的场景

✅ 需要执行自定义脚本 ✅ 需要系统级可靠性 ✅ 需要调用外部 API ✅ 需要灵活的文件操作 ✅ 简单的消息推送

使用 Cron+Heartbeat 的场景

✅ 需要精确时间 + 会话上下文 ✅ 任务需要在 OpenClaw 内部执行 ✅ 需要利用 Heartbeat 的记忆系统 ✅ 需要与会话状态联动 ✅ 复杂的记忆整理任务

📋 7. 我们的配置总结

💡 8. 扩展建议

未来可添加的任务

任务类型扩展

# 月度任务 echo "$(date '+%Y-%m-%d %H:%M:%S') - monthly" > .heartbeat-trigger # 项目特定任务 echo "$(date '+%Y-%m-%d %H:%M:%S') - suishenchuang-review" > .heartbeat-trigger # 临时任务 echo "$(date '+%Y-%m-%d %H:%M:%S') - custom-task" > .heartbeat-trigger

📝 9. 日志示例

Cron 日志

# /home/admin/.openclaw/workspace/logs/heartbeat-trigger.log [2026-04-21 23:00:00] ========================================== [2026-04-21 23:00:00] 🫀 心跳触发开始 [2026-04-21 23:00:00] ========================================== [2026-04-21 23:00:00] ✓ 触发文件已更新：daily [2026-04-21 23:00:00] ========================================== [2026-04-21 23:00:00] ✅ 心跳触发完成 [2026-04-21 23:00:00] ==========================================

Heartbeat 日志（会话内）

[2026-04-21 23:30:00] 🫀 Heartbeat 检测开始 [2026-04-21 23:30:01] 📄 发现触发文件：.heartbeat-trigger [2026-04-21 23:30:02] 📋 任务类型：daily [2026-04-21 23:30:03] 📖 读取当日记忆：memory/2026-04-21.md [2026-04-21 23:31:00] ✏️ 更新长期记忆：MEMORY.md [2026-04-21 23:32:00] 📊 检查会话状态：Context 0%, Compactions 0 [2026-04-21 23:33:00] ✅ 记忆整理完成 [2026-04-21 23:33:01] 🗑️ 删除触发文件 [2026-04-21 23:33:02] 🫀 Heartbeat 检测完成

⚠️ 10. 注意事项

Cron 配置

# 编辑 crontab crontab -e # 查看 crontab crontab -l # 备份 crontab crontab -l > crontab.bak # 恢复 crontab crontab crontab.bak

脚本权限

# 确保脚本有执行权限 chmod +x /home/admin/.openclaw/workspace/scripts/*.sh # 检查权限 ls -la /home/admin/.openclaw/workspace/scripts/

日志管理

# 查看日志 tail -f /home/admin/.openclaw/workspace/logs/heartbeat-trigger.log # 清理旧日志（保留 30 天） find /home/admin/.openclaw/workspace/logs/ -name "*.log" -mtime +30 -delete

文档维护：小龙 🐉最后更新：2026-04-21下次更新：2026-05-21

© 2026 AiToMoney 团队 | 小龙 🐉 创建