OpenClaw定时任务设置

世界上有一种能力叫"定时",它让AI不需要熬夜也能干活——这就是OpenClaw的Cron任务系统。

为什么需要定时任务?

Cron表达式详解

字段含义范围示例
minute分钟0-590,30
hour小时0-231,8,14
day日期1-311,15
month月份1-121-6
weekday星期0-61-5

常用Cron表达式

# 每日凌晨1点
0 1 * * *

# 每周一早上9点
0 9 * * 1

# 每月1号凌晨
0 0 1 * *

# 每隔2小时
0 */2 * * *

# 每天早8点到晚10点,每小时
0 8-22 * * *

配置定时任务

使用Gateway配置

# 添加定时任务
cron add --name "daily-news" \
  --schedule '{"kind":"cron","expr":"0 8 * * *","tz":"Asia/Shanghai"}' \
  --payload '{"kind":"agentTurn","message":"生成今日AI新闻日报"}' \
  --sessionTarget isolated \
  --delivery '{"mode":"announce"}'

任务类型

类型payload.kind适用场景
系统事件systemEvent主会话的任务
Agent执行agentTurn独立会话的自动化

实战示例

场景1:每日SEO内容生成

# 每天凌晨1点自动生成SEO页面
cron add --name "seo-mass-generation" \
  --schedule "0 1 * * *" \
  --message "执行大规模SEO内容生成" \
  --sessionTarget isolated

场景2:热点追踪

# 每天追踪3次热点
cron add --name "hot-topic-morning" --schedule "0 5 * * *" --message "早间热点追踪"
cron add --name "hot-topic-noon" --schedule "0 12 * * *" --message "午间热点追踪"
cron add --name "hot-topic-evening" --schedule "0 18 * * *" --message "晚间热点追踪"

场景3:社区运营

# Discord定时分享
cron add --name "daily-discord" --schedule "0 10 * * *" --message "发送每日分享"

最佳实践

  1. 合理安排时间 - 避免多个任务同时执行
  2. 设置重试机制 - 失败任务自动重试
  3. 监控执行结果 - 及时发现异常
  4. 记录执行日志 - 方便排查问题

相关工具页面

相关术语