Cron 任务

定时执行任务。

概述

Cron 任务在 Gateway 内运行，可以：

• 按计划执行
• 发送系统事件
• 发送消息

添加任务

# 每小时运行
openclaw cron add --name "hourly-check" --every 1h --system-event "检查状态"

# Cron 表达式（每天 9 点）
openclaw cron add --name "daily-report" --cron "0 9 * * *" --message "生成日报"

# 指定时间运行一次
openclaw cron add --name "one-time" --at "2024-12-31T23:59:00" --message "新年快乐"

管理任务

# 列出任务
openclaw cron list

# 查看状态
openclaw cron status

# 启用/禁用
openclaw cron enable <id>
openclaw cron disable <id>

# 编辑
openclaw cron edit <id> --every 2h

# 删除
openclaw cron rm <id>

# 手动运行
openclaw cron run <id> --force

# 查看运行历史
openclaw cron runs --id <id> --limit 10

Cron 表达式

标准 5 字段 cron 格式：

分 时 日 月 周

示例：

• 0 9 * * * - 每天 9:00
• */30 * * * * - 每 30 分钟
• 0 0 * * 0 - 每周日 0:00

时区

指定时区：

openclaw cron add --name "task" --cron "0 9 * * *" --tz "Asia/Shanghai" --message "早安"

注意事项

• Cron 在 Gateway 进程内运行
• Gateway 必须持续运行
• 任务错过不会补执行

相关文档

• Cron vs Heartbeat
• CLI cron