> ## Documentation Index
> Fetch the complete documentation index at: https://claw-tw.jackle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# cron（排程管理）

# `openclaw cron`

管理 Gateway 排程器中的排程任務。

相關資訊：

* 排程任務：[Cron jobs](/zh-Hant/automation/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`。

升級說明：如果您擁有來自目前遞送/儲存格式之前的舊排程任務，請執行 `openclaw doctor --fix`。Doctor 現在會正規化舊版排程欄位（`jobId`、`schedule.cron`、頂層遞送欄位、payload `provider` 遞送別名）並在設定了 `cron.webhook` 時將簡單的 `notify: true` webhook 回退任務遷移至明確的 webhook 遞送。

## 常見編輯操作

在不變更訊息內容的情況下更新遞送設定：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw cron edit <job-id> --announce --channel telegram --to "123456789"
```

為獨立任務停用遞送：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw cron edit <job-id> --no-deliver
```

為獨立任務啟用輕量啟動情境：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw cron edit <job-id> --light-context
```

對特定頻道進行公告：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw cron edit <job-id> --announce --channel slack --to "channel:C1234567890"
```

建立帶有輕量啟動情境的獨立任務：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 執行，輕量模式讓啟動情境保持為空，而非注入完整的工作區啟動集。