openclaw cron

Gatewayスケジューラーのcronジョブを管理します。

関連:

ヒント:openclaw cron --helpで全コマンドを確認できます。

補足:分離されたcron addジョブはデフォルトで--announce配信になります。出力を内部に留めるには--no-deliverを使用してください。--deliver--announceの非推奨エイリアスとして残っています。

補足:ワンショット(--at)ジョブは成功後にデフォルトで削除されます。保持するには--keep-after-runを使用してください。

補足:定期ジョブは連続エラー後に指数バックオフリトライを使用します(30秒 → 1分 → 5分 → 15分 → 60分)。次の成功後に通常のスケジュールに戻ります。

補足: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フィールド(jobIdschedule.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は分離エージェントターンジョブにのみ適用されます。cron実行では、軽量モードは完全なワークスペースブートストラップセットを注入する代わりにブートストラップコンテキストを空のままにします。