cron

openclaw cron

管理 Gateway(网关) 网关 调度器的 cron 作业。

相关：

• Cron 作业：Cron 作业

提示：运行 openclaw cron --help 查看完整的命令表面。

注意：隔离的 cron add 作业默认为 --announce 投递。使用 --no-deliver 将 输出保留在内部。--deliver 保留为 --announce 的已弃用别名。

注意：一次性 (--at) 作业默认在成功后删除。使用 --keep-after-run 保留它们。

注意：对于一次性 CLI 作业，不带偏移量的 --at 日期时间将被视为 UTC，除非您还传递了 --tz <iana>，这会将该本地挂钟时间解释为在给定的时区中。

注意：周期性作业现在在连续错误后使用指数退避重试（30s → 1m → 5m → 15m → 60m），然后在下次成功运行后恢复正常调度。

注意：openclaw cron run 现在会在手动运行被排队执行后立即返回。成功的响应包含 { ok: true, enqueued: true, runId }；请使用 openclaw cron runs --id <job-id> 来跟踪最终结果。

注意：保留/修剪由配置控制：

• cron.sessionRetention（默认为 24h）修剪已完成的隔离运行会话。
• cron.runLog.maxBytes + cron.runLog.keepLines 修剪 ~/.openclaw/cron/runs/<jobId>.jsonl。

升级说明：如果您有来自当前交付/存储格式之前的较旧 cron 作业，请运行 openclaw doctor --fix。Doctor 现在会规范化旧版 cron 字段（jobId、schedule.cron、 包括旧版 threadId 的顶级交付字段、payload provider 交付别名），并在配置 cron.webhook 时将简单的 notify: true webhook 后备作业迁移到显式 webhook 交付。

常见编辑

在不更改消息的情况下更新传递设置：

openclaw cron edit <job-id> --announce --channel telegram --to "123456789"

禁用隔离作业的传递：

openclaw cron edit <job-id> --no-deliver

为隔离作业启用轻量级引导上下文：

openclaw cron edit <job-id> --light-context

向特定渠道宣布：

openclaw cron edit <job-id> --announce --channel slack --to "channel:C1234567890"

创建具有轻量级引导上下文的隔离作业：

openclaw cron add \
  --name "Lightweight morning brief" \
  --cron "0 7 * * *" \
  --session isolated \
  --message "Summarize overnight updates." \
  --light-context \
  --no-deliver

--light-context 仅适用于隔离的 agent-turn 作业。对于 cron 运行，轻量级模式保持 bootstrap 上下文为空，而不是注入完整的工作区 bootstrap 集。