毎日の定期実行は便利ですが、タイムゾーン設定を曖昧にすると、想定より早く動いたり遅れて動いたりして運用事故につながります。特に、ローカル環境と実行環境で時刻の前提が異なる場合は、最初に設定を固めておく必要があります。
結論: OpenClawジョブのタイムゾーン設定は、最小構成で始めてログを見ながら段階的に広げるのが最短です。
Background
毎日の運用タスクは、手作業だと実行漏れや設定ブレが起きやすくなります。まずは小さく自動化し、安定して動くことを確認してから対象を広げるのが安全です。
そのときに見落としやすいのがタイムゾーンです。9:00に実行するつもりでも、実行基盤がUTC前提だと日本時間の夕方や深夜に動くことがあります。
Step-by-step
1. 目的と対象範囲を決める
最初は1つの処理だけを自動化対象にします。成功条件として、いつ実行されるかと何が完了していれば成功かを先に決めておくと、検証がぶれません。
たとえば、毎朝9時にレポートを実行し、結果を要約して保存するのように、時刻と期待結果を具体化しておくのが有効です。
2. 最小構成でジョブを登録する
タイムゾーンは明示的に指定します。日本時間で運用するなら、Asia/Tokyoを使うのが基本です。
1
2
3
4
5
6
7
# 毎日 09:00（Asia/Tokyo）に実行する最小構成の例
openclaw cron add \
--name "daily-sample" \
--cron "0 9 * * *" \
--tz "Asia/Tokyo" \
--session isolated \
--message "ジョブを実行して結果を要約"
この設定では、cron式の0 9 * * *をAsia/Tokyoとして解釈します。--tzを省略すると、環境によってはUTCやホスト既定のタイムゾーンで評価される可能性があるため、省略しない運用を推奨します。
3. まずは短い間隔で検証する
本番投入前に、日次ジョブだけでなく短い間隔のテストジョブで挙動を確認すると安全です。実行時刻のずれや認証エラーを早く見つけられます。
1
2
3
4
5
6
7
# 検証用: 5分ごとに実行してログを確認する
openclaw cron add \
--name "timezone-check" \
--cron "*/5 * * * *" \
--tz "Asia/Tokyo" \
--session isolated \
--message "現在時刻と実行結果を記録して要約"
短周期のジョブで問題がなければ、日次や週次のスケジュールに切り替えます。いきなり本番の時刻だけで試すと、異常に気づくまで半日から1日遅れることがあります。
4. ログと出力を確認する
ジョブ登録後は、想定した日本時間に開始しているかをログで確認します。処理本体が成功していても、開始時刻がずれていればスケジュール設定は未完成です。
失敗時は、再実行手順もあわせて決めておきます。通知メッセージは短くしつつ、どのジョブが、いつ、なぜ失敗したかが分かる形に揃えると運用しやすくなります。
Common pitfalls
-
--tzを省略している
実行環境の既定タイムゾーンに依存するため、意図しない時刻に動く原因になります。運用ジョブでは毎回--tz "Asia/Tokyo"のように明示してください。 -
cron式は合っているのに、確認基準の時刻が混在している
ログはUTC、運用メモはJST、通知はローカル時刻、という状態だと切り分けが難しくなります。運用ドキュメント、通知、確認手順の基準時刻を日本時間に統一してください。 -
認証切れで定期実行だけ失敗する
手動実行では通るのにcronだけ失敗する場合、トークンやセッションの有効期限切れがよくあります。定期ジョブ化する前に、隔離セッションで必要な認証が維持できるか確認しておくべきです。 -
依存サービスの停止を考慮していない
ローカルLLM、外部API、ストレージなどが落ちていると、スケジュール自体は正常でも処理が失敗します。失敗時にどこを確認するか、最低限の切り分け手順を先に作っておくと復旧が速くなります。 -
いきなり複数ジョブを本番投入している
タイムゾーン設定ミスがあると、複数ジョブがまとめてずれます。最初は1本だけ登録し、ログで想定どおりの起動時刻を確認してから増やすのが安全です。
Summary
OpenClawジョブのタイムゾーン設定では、cron式だけでなくその式をどのタイムゾーンで解釈するかを明示することが重要です。日本時間で運用するなら、--tz "Asia/Tokyo"を前提にして設定を統一してください。
運用の進め方としては、最小構成で開始し、短周期ジョブで時刻と認証を検証し、ログ確認後に日次運用へ広げる流れが堅実です。開始時刻のずれは後から気づきにくいため、最初の1本を丁寧に確認することが安定運用への近道です。