1. 心跳检查（HEARTBEAT）#

本质：一种被动响应机制，由外部定时触发（通过 Cron 或其他调度器），AI 收到特定消息后读取 HEARTBEAT.md 文件并执行检查。

工作流程： 外部定时器 → 发送心跳消息 → AI 读取 HEARTBEAT.md → 执行检查逻辑 → 返回结果

特点：

• ✦ 需要外部触发（通常是 Cron job）
• ✦ 每次触发都会重新读取 HEARTBEAT.md
• ✦ 适合轻量级检查任务
• ✦ 灵活性高，检查内容可随时修改

2. Cron 定时任务#

本质：OpenClaw 内置的主动调度机制，通过配置文件定义任务周期、执行内容、投递方式。

工作流程： Cron 调度器 → 时间到达 → 执行 payload 定义的任务 → 通过 delivery 投递结果

特点：

• ✦ 完全自动化，无需外部触发
• ✦ 支持复杂的 Cron 表达式
• ✦ 支持任务状态追踪（运行次数、上次状态等）
• ✦ 适合需要精确控制执行频率的任务

基础配置#

在 workspace 目录下创建 \HEARTBEAT.md\：

\\markdown

配置文件位置#

~/.openclaw/cron/jobs.json\

完整配置示例#

\\json { “version”: 1, “jobs”: [ { “id”: “daily-summary”, “name”: “每日总结”, “enabled”: true, “schedule”: { “kind”: “cron”, “expr”: “50 22 * * *”, “tz”: “Asia/Shanghai” }, “sessionTarget”: “isolated”, “wakeMode”: “now”, “payload”: { “kind”: “agentTurn”, “message”: “请总结当天的聊天记录，包括：1. 当天完成的主要事项 2. 学习心得或技术收获 3. 待办事项或后续跟进内容。用简洁的markdown格式输出。” }, “delivery”: { “mode”: “announce”, “channel”: “qqbot”, “to”: “用户QQ号” } } ] } \\

字段说明#

Cron 表达式详解#

示例：Node.js 定时任务#

创建一个独立的 JavaScript 文件来管理定时任务：

\\javascript // 文件：tools/scheduled-task.js

const fs = require(‘fs’); const path = require(‘path’);

// 简单的定时任务调度器 class TaskScheduler { constructor() { this.tasks = new Map(); this.interval = null; }

// 注册任务 register(name, schedule, callback) { this.tasks.set(name, { schedule, callback, lastRun: 0 }); }

// 检查任务是否应该执行 shouldRun(task) { const now = Date.now(); const interval = this.parseSchedule(task.schedule); return now - task.lastRun >= interval; }

// 解析调度表达式（简化版） // 支持格式：30m = 30分钟，1h = 1小时，1d = 1天 parseSchedule(schedule) { const units = { ‘m’: 60 * 1000, // 分钟转毫秒 ‘h’: 60 * 60 * 1000, // 小时转毫秒 ‘d’: 24 * 60 * 60 * 1000 // 天转毫秒 }; const match = schedule.match(/^(\d+)([mhd])$/); return match ? parseInt(match[1]) * units[match[2]] : 60 * 1000; }

// 启动调度器 start(intervalMs = 60000) { this.interval = setInterval(() => { this.tasks.forEach((task, name) => { if (this.shouldRun(task)) { console.log([Task] Executing: \); task.callback(); task.lastRun = Date.now(); } }); }, intervalMs); console.log(‘[TaskScheduler] Started’); } }

// ============ 使用示例 ============

const scheduler = new TaskScheduler();

// 任务1：每30分钟执行 scheduler.register(‘health-check’, ‘30m’, () => { console.log(‘Running health check…’); // 执行健康检查逻辑 });

// 任务2：每小时执行 scheduler.register(‘cleanup’, ‘1h’, () => { console.log(‘Running cleanup…’); // 执行清理逻辑 });

// 任务3：每天执行 scheduler.register(‘daily-report’, ‘1d’, () => { console.log(‘Generating daily report…’); // 生成日报逻辑 });

// 启动调度器（每分钟检查一次） scheduler.start(60000); \\

通过 Exec 工具调用#

在 OpenClaw 中配置 Exec 工具调用：

\\json { “name”: “scheduled-task”, “command”: “node C:\\Users\\Rookie\\.openclaw\\tools\\scheduled-task.js”, “background”: true, “timeout”: 300 } \\

或者使用 Python 版本：

\\python

1. 选择原则#

• 轻量检查 → 用心跳检查 + 外部 Cron
• 精确调度 → 用 Cron 任务
• 复杂逻辑 → 用代码级定时任务

2. 避免过度使用#

• ❌ 避免设置过于频繁的任务（如每分钟）
• ❌ 避免执行耗时较长的任务
• ✅ 合理设置任务周期，给 AI 充足的处理时间

3. 监控与调试#

• 定期检查任务执行状态
• 关注任务运行时间变化
• 设置合理的超时时间