openclaw cron で Gateway のスケジュール管理を効率化する

`openclaw cron`

開発を進めていると、定期的なスクリプトの実行や、特定の時間に一度だけ動かしたいタスクの管理に苦労することがありますよね。設定が複雑だったり、実行結果の確認が面倒だったりと、スケジューリングは意外と手間がかかるものです。

Gateway のスケジューラーで cron ジョブを効率よく管理するための openclaw cron コマンドについて解説します。これを使えば、通知設定やリトライ処理もスマートに制御できるようになります。

関連ドキュメント：

Cron ジョブ: Cron jobs

ヒント：コマンドの全容を確認するには openclaw cron --help を実行してください。

注意：独立した cron add ジョブは、デフォルトで --announce（通知あり）の設定になります。出力を内部のみに留めたい場合は --no-deliver を使用してください。なお、--deliver は --announce の非推奨のエイリアスとして残されています。

注意：単発実行（--at）ジョブは、デフォルトで成功後に削除されます。実行後も残しておきたい場合は --keep-after-run を使用してください。

注意：CLI での単発ジョブにおいて、オフセットのない --at 日時は UTC として扱われます。特定のタイムゾーンで解釈させたい場合は --tz <iana> を指定してください。

注意：定期実行ジョブでエラーが連続した場合、指数バックオフによるリトライ（30秒 → 1分 → 5分 → 15分 → 60分）が行われるようになりました。次回の実行が成功すると、通常のスケジュールに戻ります。

注意：openclaw cron run は、手動実行がキューに追加された直後にレスポンスを返すようになりました。成功時のレスポンスには { ok: true, enqueued: true, runId } が含まれます。最終的な結果を追跡するには openclaw cron runs --id <job-id> を使用してください。

注意：保持期間とクリーンアップは設定ファイルで制御できます：

cron.sessionRetention (デフォルト 24h): 完了した isolated 実行セッションを削除します。
cron.runLog.maxBytes + cron.runLog.keepLines: ~/.openclaw/cron/runs/<jobId>.jsonl のログを削除します。

アップグレードに関する注意：現在の配信・保存形式より前の古い cron ジョブがある場合は、openclaw doctor --fix を実行してください。Doctor コマンドがレガシーなフィールド（jobId, schedule.cron, threadId を含むトップレベルの配信フィールド、provider エイリアスなど）を正規化し、cron.webhook が設定されている場合はシンプルな notify: true 設定を明示的な Webhook 配信へと移行します。

よく使われる編集操作

メッセージを変更せずに配信設定のみを更新する場合：

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

isolated ジョブの配信を無効にする場合：

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

isolated ジョブで軽量な bootstrap context を有効にする場合：

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

特定のチャンネルに通知する場合：

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

軽量な bootstrap context を使用して isolated ジョブを作成する場合：

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

--light-context は isolated な agent-turn ジョブにのみ適用されます。cron 実行において軽量モードを使用すると、ワークスペース全体の bootstrap セットを注入する代わりに、bootstrap context を空のまま保持します。

次のステップ

セットアップで困ったときは、いつでも AI Setup Assistant に相談してください。

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。