JSON Schema（工具调用）

一次性主会话任务

json
{
name: 提醒,
schedule: { kind: at, at: 2026-03-04T10:00:00Z },
sessionTarget: main,
wakeMode: now,
payload: { kind: systemEvent, text: 提醒内容 },
deleteAfterRun: true
}

周期性独立会话任务

json
{
name: 晨间简报,
schedule: { kind: cron, expr: 0 7 *, tz: Asia/Shanghai },
sessionTarget: isolated,
wakeMode: next-heartbeat,
payload: { kind: agentTurn, message: 总结隔夜更新 },
delivery: {
mode: announce,
channel: telegram,
to: +8613800138000,
bestEffort: true
}
}

投递模式（Delivery）

仅适用于 isolated 任务：

省略 delivery 时默认行为： announce 模式

Telegram 话题投递

支持论坛话题（topic）：

bash
--to -1001234567890:topic:123 # 推荐：显式话题标记
--to -1001234567890:123 # 简写：数字后缀

配置示例（参考）

当前工作配置示例（~/.openclaw/cron/jobs.json）：

json
{
name: daily-health-summary,
schedule: {
kind: cron,
expr: 0 10 *,
tz: Asia/Shanghai
},
sessionTarget: isolated,
payload: {
kind: agentTurn,
message: 从 Bitable 查询健康数据并生成总结
},
delivery: {
mode: none,
channel: last
}
}

故障排查

任务不执行

1. 1. 检查 cron 是否启用：cron.enabled: true（配置中）
2. 检查 Gateway 是否持续运行（cron 在 Gateway 进程内执行）
3. 确认时区设置正确（--tz 参数）

任务反复延迟

• - 连续失败会触发指数退避：30s → 1m → 5m → 15m → 60m
• 成功执行后退避重置

查看存储位置

• - 任务存储：~/.openclaw/cron/jobs.json
• 运行历史：~/.openclaw/cron/runs/.jsonl

高级配置

在 ~/.openclaw/config.json 中：

json5
{
cron: {
enabled: true,
sessionRetention: 24h, // 独立会话保留时长
runLog: {
maxBytes: 2mb, // 运行日志最大大小
keepLines: 2000, // 保留行数
},
}
}

Cron vs Heartbeat