Skip to content

定时任务

概述

OpenClaw 支持定时任务(Cron Jobs),让 Agent 不仅被动响应消息,还能定期主动执行任务。

心跳(Heartbeat)

心跳是 OpenClaw 最核心的定时任务功能。它像生物钟一样,每隔一段时间唤醒 AI,让 AI 读取当前状态和 HEARTBEAT.md 文件,自主判断「我现在该不该为你做点什么」。

推荐频率

使用强度建议间隔
轻度使用每 2-4 小时一次
中度使用每 1-2 小时一次
重度使用每 30 分钟一次

注意 Token 消耗

每次心跳都会消耗 Token。入门阶段建议保持禁用状态,等到重度使用且 Token 充足时再开启。

管理心跳

bash
# 查看心跳状态
openclaw cron list

# 设置心跳间隔
openclaw cron set heartbeat "0 */2 * * *"  # 每 2 小时

# 禁用心跳
openclaw cron disable heartbeat

自定义定时任务

除了心跳,你还可以创建自定义定时任务:

bash
# 添加定时任务
openclaw cron add "0 9 * * *" "发送每日新闻摘要"

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

使用场景

  • 每日摘要:每天早上自动汇总昨天的重要信息
  • 定时提醒:到点自动发送提醒消息
  • 数据同步:定期从外部 API 拉取数据
  • 健康检查:定时检查服务运行状态

基于 MIT 协议发布