OpenClaw定时执行任务的完整方案

OpenClaw不仅能聊天，更核心的能力是自动执行定时任务。官方提供了两种主要机制：Cron定时任务（精确调度）和Heartbeat心跳（周期性感知），此外还可以通过阿里云AppFlow实现低代码配置。

一、核心概念：Cron vs Heartbeat

在开始配置前，需要理解两种机制的区别：

Cron定时任务：Gateway网关内置的精确调度器。适合需要精确定时的场景，如“每天早上9点发送报告”或“20分钟后提醒我”。任务持久化存储在~/.openclaw/cron/，重启不会丢失。

Heartbeat心跳：在主会话中以固定间隔运行（默认30分钟）。适合批量周期性检查，如同时检查收件箱、日历、天气等，一次心跳处理多个任务，更经济高效。

快速决策指南：

需要精确时间（如上午9:00）→ 用Cron

需要独立任务且不影响主会话 → 用Cron隔离式

多个周期性检查批量处理 → 用Heartbeat（添加到HEARTBEAT.md）

一次性提醒 → 用Cron配合--at

二、通过Cron定时任务实现（精确调度）

Cron支持三种调度类型：一次性（at）、固定间隔（every）、Cron表达式。以下为完整命令示例：

1. 一次性提醒（20分钟后）：

openclaw cron add --name "Meeting reminder" --at "20m" --session main --system-event "Reminder: standup meeting starts in 10 minutes." --wake now --delete-after-run

2. 每日早间简报（隔离式，带投递）：

openclaw cron add --name "Morning brief" --cron "0 7 * * *" --tz "Asia/Shanghai" --session isolated --message "Summarize overnight updates." --announce --channel tele gram --to "123456789"

3. 每4小时检查项目状态（主会话）：

openclaw cron add --name "Check project" --every "4h" --session main --system-event "Time for a project health check" --wake now

关键参数说明：

--session：main（使用主会话上下文）或isolated（专用会话，不污染历史）

--announce/--no-deliver：是否投递摘要到聊天渠道

--model：隔离任务可覆盖模型（如opus）

--delete-after-run/--keep-after-run：一次性任务默认成功删除，保留需加--keep-after-run

三、通过Heartbeat心跳实现（周期批量检查）

Heartbeat在主会话中定期运行，适合多项检查批量处理。配置方式：

1. 编辑HEARTBEAT.md文件：

位置：~/.openclaw/workspace/HEARTBEAT.md。

示例内容：

# Heartbeat checklist

- Check email for urgent messages

- Review calendar for events in next 2 hours

- If a background task finished, summarize results

- If idle for 8+ hours, send a brief check-in

2. 配置心跳间隔（在~/.openclaw/openclaw.json中）：

{ "agents": { "defaults": { "heartbeat": { "every": "30m", "target": "last", "activeHours": { "start": "08:00", "end": "22:00" } } } } }

优势：一次心跳处理多项检查，减少API调用，且有上下文感知能力。

四、通过阿里云AppFlow配置（低代码方案）

如果你使用阿里云轻量应用服务器部署OpenClaw，可以通过AppFlow可视化配置定时任务，无需命令行。

1. 访问AppFlow模板：使用“定时调用OpenClaw并发送钉钉/飞书/企业微信消息”模板创建连接流。

2. 配置触发周期：使用cron表达式生成工具，选择重复频率（如每小时），系统自动生成表达式。

3. 配置执行动作：

输入指令：填写想要定时执行的指令，如“提醒我每小时定点喝水100ml”。

公网地址端口：格式为你的服务器公网IP:18789。

Webhook地址：复制钉钉/飞书机器人的Webhook并粘贴。

4. 发布并验证：发布后定时功能生效，可点击“运行一次”测试。

五、定时任务管理命令

查看所有定时任务：openclaw cron list

立即运行任务：openclaw cron run <job-id> --force

查看任务执行历史：openclaw cron runs --id <job-id>

编辑任务投递设置：openclaw cron edit <job-id> --announce --channel tele gram --to "123456789"

禁用投递：openclaw cron edit <job-id> --no-deliver

任务存储位置：~/.openclaw/cron/jobs.json（Gateway管理，手动编辑需停止服务）

六、实战场景示例

每日早间简报：每天早上7点发送天气、日历事件、新闻摘要到Tele gram。

openclaw cron add --name "Morning brief" --cron "0 7 * * *" --tz "Asia/Shanghai" --session isolated --message "Today's weather in Beijing, my first three calendar events, top three BBC headlines. Keep under 150 words." --model opus --announce --channel tele gram --to "频道ID"

每小时喝水提醒：每小时整点发送提醒到飞书。

通过AppFlow配置：cron表达式0 * * * *，指令“提醒我每小时定点喝水100ml”。

监控品牌提及：每天上午9点搜索X平台品牌提及并生成报告。

openclaw cron add --name "Brand monitor" --cron "0 9 * * *" --session isolated --message "Search X for [品牌名] mentions from past 24h. Summarize: total count, sentiment breakdown, top engaged posts, complaints needing attention." --announce --channel slack --to "channel:C1234567890"

七、常见问题与避坑指南

任务不执行怎么办？ 检查Gateway是否运行：openclaw gateway status。确保cron服务未禁用：配置中cron.enabled: true。

时区问题：cron表达式默认使用主机时区，建议显式指定--tz "Asia/Shanghai"。

一次性任务保留：默认成功删除，如需保留加--keep-after-run。

投递失败：可设置--best-effort避免任务失败。

心跳与cron组合使用：心跳处理常规监控（每30分钟），cron处理精确调度（每日报告），是最经济高效的配置。