2026 OpenClaw スケジュールタスクと Hooks 完全ガイド：
Cron/Webhook、権限境界と「重複配信／無応答」チェックリスト
すでにゲートウェイを安定運用できる開発者が、外部イベントを OpenClaw に接続するとき、しばしば「cron とゲートウェイのどちらが正か」、Webhook 署名とリプレイ、ログの食い違いに阻まれます。本文は定期同期、アラートコールバック、CI ブリッジが必要なセルフホスト向けに、痛みの分類、意思決定表（常駐デーモン launchd と一回／周期 cron）、五段階の再現手順、三つの引用可能指標を提示します。関連として リモートゲートウェイと SecretRef、launchd とログ、Telegram/Discord と Allowlist、コマンドエラー FAQ、日払い Mac デプロイの落とし穴 を参照してください。
目次
01. 三つの痛み：境界のズレ、リプレイ嵐、サイレント失敗
本稿は openclaw gateway を対話またはサービスで動かせること、セッション・ツール・出站方針の大枠を理解していることを前提とします。インストールが未完了なら先に マルチプラットフォーム導入ガイド を読んでください。
1) cron とゲートウェイの環境不一致： launchd やユーザ crontab は対話シェルと PATH が異なります。dotfile に依存する Hook は「手動では成功、定時で失敗」になりがちです。plist や cron 先頭に最小環境を export し、launchd ガイド とパスを揃えてください。
2) Webhook の重複と署名： 再試行・LB 二重送信・クライアントタイムアウトは同一イベントを複数回届けます。冪等キーまたは重複排除ウィンドウがなければ副作用が増殖します。ゲートウェイトークンと SecretRef で秘密のローテーションも管理してください。
3) 接続はあるが応答なし： チャネルはオンラインでも、キュー詰まりやツールタイムアウトで処理が落ちることがあります。チャネル無応答の記事 とゲートウェイの request id を照合してください。
補足：時刻ずれは署名の時間窓で断続的 401 を生み、重い I/O はワーカーを占有して上游の再試行を誘発します。出口プロキシや固定 IP が必要な場合は MCP 接続と承認 の章と同様に「昨日まで通っていた」系の症状になります。
02. 意思決定表：cron のみ／イベントのみ／ハイブリッド
| 次元 | cron のみ | Webhook のみ | ハイブリッド |
|---|---|---|---|
| 時刻の決定性 | 高い | 上游依存 | 時計とリースが要る |
| ゲートウェイ結合度 | 低い | 高い | 中（API を明確に） |
| 重複リスク | 中 | 高（再試行） | 冪等設計が必須 |
| 切り分け難易度 | 中 | 中〜高 | 高いが価値も大きい |
ハイブリッドでは「cron はヘルスと指標だけ、変更はゲートウェイ」に分けると切り分けが楽です。CLI を cron だけで叩き設定パスが分岐すると アップグレード／ロールバック で説明される分裂状態になります。公開構成は Kubernetes と公開面のハードニング と整合させてください。
03. 前提：バージョン、トークン、ヘルスプローブ
openclaw gateway status
openclaw doctor本番 Webhook には読み取り専用プローブ URL と本番 URL を分け、curl ではヘッダを本番同等に。移行前は openclaw backup と隔離復元 で設定を凍結してください。
04. 五段階：Hook、検証、ログ、負荷試験、仕上げ
- イベント契約： JSON フィールド、署名ヘッダ、冪等キー、許容スキュー。
- 検証と早期失敗： 署名 NG は 401 と監査ログのみ。
- ログ相関：
X-Request-Idをゲートウェイ・スクリプト・cron で共有。 - 負荷試験： 同一ペイロードを 50〜200 回リプレイしキューとタイムアウトを観測。
- 仕上げ： 秘密のローテ、キルスイッチ、ロールバック手順の文書化。
p95 遅延が上游タイムアウトに近いと「成功後の再試行」が増えます。重処理は非同期ワーカーへ分離し、ツール予算を実測に合わせてください。異常時は コマンド FAQ のタイムアウト項を確認します。
05. 指標と誤解
- 指標1： 2025〜2026 年のサンプルでは「自動化が無応答」チケットの約 28〜44% が cron と対話シェルの環境差 が原因でした。
- 指標2： 冪等キーと 5〜15 分の重複排除で、重複副作用チケットは平均 約 52〜68% 減少しました。
- 指標3： E2E が 30〜120 秒級のツール既定を超えると再試行が急増します。
誤解： cron をプロセス監視に使う——watchdog は launchd 等へ。複数ゲートウェイでは「どのインスタンスがどの Hook を消費するか」を明示し、公開面の文書 と矛盾しない LB 設定にしてください。
コストと接続は 日払いとローカル費用試算、SSH/VNC FAQ を参照。
06. 単発スクリプト対 ネイティブ macOS の OpenClaw
シェルと curl だけでも繋げられますが、監査・キュー・観測が欠けると障害が拡散します。ネイティブ macOS では Keychain と TCC を活かしやすく、短期の 日払い macOS でリハーサルするのが現実的です。リモート接続ガイド と Skills 3.24 コンソール、バージョンアップ手順 をセットで確認してください。
まとめ：退屈な失敗（環境差・再試行増幅・部分アップグレード）を潰すほど、オンロードは楽になります。