openclaw cron

管理 Gateway 排程器的 cron 任務。

相關資源：

• Cron 任務：Cron jobs

提示：執行 openclaw cron --help 查看完整的指令介面。

注意：隔離的 cron add 任務預設使用 --announce 傳遞。使用 --no-deliver 讓輸出保持內部。--deliver 仍作為已棄用的別名保留。

注意：單次執行（--at）任務在成功後預設會自動刪除。使用 --keep-after-run 保留它們。

注意：週期性任務在連續錯誤後會使用指數退避重試（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、頂層傳遞欄位、載荷 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 執行中，輕量模式會讓引導上下文保持空白，而非注入完整的工作區引導集。