2026 クラウド Mac：OpenClaw 組み込み cron スケジューラと launchd による安全な自動化パターン
OpenClaw をレンタルした Apple Silicon に載せたチームは、すぐに「毎朝このスクリプトを手で回す」運用の限界に達します。OpenClaw 公式の cron スケジューラはジョブをゲートウェイの横に永続化し、名前付きセッションを対象にし、隔離されたエージェントターンをキューに入れられます。launchd と再起動の意味論を奪い合う二重スケジューラを無理に足さなくてよい、というのが 2026 年のクラウド Mac（MacLogin の香港・日本・韓国・シンガポール・米国ホスト）での実務的メリットです。本稿ではその理由、CLI 動詞の地図、メイン実行と隔離実行の採点表、10 手順のロールアウト、コミュニティで語られる macOS の ゲートウェイ再起動＋LaunchAgent の落とし穴、タイムゾーンとログの落とし穴、FAQ、Mac mini M4 の容量メモをまとめます。
何かを刻む前に、デーモン周りは ゲートウェイデーモンのトラブルシュート で健康状態を確認し、秘密は 展開と Secrets 管理 に揃え、可観測性は CLI フックと監査ログ で補強してください。接続の基本は MacLogin ヘルプ にあります。OpenClaw を fleet で上げるときは ブログ索引 から関連プレイブックを辿りましょう。スケジューラのデフォルトはマイナー版の間でも変わり得ます。
2026 年、組み込み cron がアドホック crontab に勝つ理由
macOS にも cron はありますが、ユーザ crontab は OpenClaw のセッション模型から見えません。チャット駆動の実行と同じテレメトリを伴う構造化された「エージェントターン」を crontab だけでは積めません。ネイティブの openclaw cron ジョブはゲートウェイの認証コンテキストを引き継ぎ、ワークスペースルートを尊重し、健全な LaunchAgent と組み合わせれば再起動後も残ります——ただし cron が起こしたエージェントの内側からゲートウェイを再帰的に再起動しないことが条件です。
- 単一の真実： cron と LaunchAgent の二重タイマーが衝突しにくい。
- セマンティクス： 対話の「脳」に載せるか、隔離サンドボックスの 1 ターンに閉じるかを選べる。
- ディスク衛生： 定義は
~/.openclaw/cron/に置かれる——他の状態ディレクトリと同様にバックアップ設計が要る。
実際に打つ Cron CLI 動詞
| コマンド系 | 目的 | メモ |
|---|---|---|
openclaw cron add |
--cron または一回限り --at で名前付きスケジュールを作る |
分散チームでは必ず --tz を明示 |
openclaw cron list |
ジョブ一覧と次回発火時刻 | 週次で設定管理へエクスポート |
openclaw cron run |
名前付きジョブの手動ドライラン | 本番カデンスに上げる前に必須 |
メインセッション対隔離ターン：判断表
| シナリオ | メインセッション投入を優先 | 隔離ターンを優先 |
|---|---|---|
| Slack への日次スタンドアップ要約 | はい——会話メモリを再利用 | 稀 |
| 破壊的なファイル掃除バッチ | いいえ——クロストークのリスク | はい |
| 時間ごとのメトリクス取得とチャート | プロンプトが冪等なら可 | ツール権限が広いならはい |
| データ分離契約のある規制顧客 | ワークスペース厳格分離時のみ | 既定は隔離 |
MacLogin クラウド Mac 向け Cron 10 手順ロールアウト
- ランタイム固定： Node 22 LTS と OpenClaw パッケージハッシュを社内変更ログに残す。
- メモリ下限： 時間ごとの隔離ターンを有効にする前にホストに 16 GB 以上 の統合 RAM を割り当てる。
- ゲートウェイ緑：
openclaw doctorを実行し、赤項目を潰す。 - 命名：
チーム-リージョン-目的規則（例sre-sin-cost-report）。 - タイムゾーン： ジョブごとに
--tzを保存；米国と APAC が混在するならサーバローカル暗黙に頼らない。 - ドライラン：
openclaw cron runを静かな実行と詳細実行の二度試す。 - ログ： JSONL 行を フック監査 と同じシンクへミラーする。
- アラート： 15 分 ウォールクロック以内に連続 3 回の予定実行が欠けたらページする。
- ロールバック： 直前のジョブ定義を git に最低 7 日 保持する。
- レビュー： 四半期ごとにビジネスオーナーのいないジョブを削除する。
launchd とゲートウェイ再起動の罠
コミュニティの issue では、macOS 上でエージェントセッションの内側から openclaw gateway restart を呼ぶと、LaunchAgent が置換起動の完了前にアンロードされ、手動でゲートウェイを入れ直す羽目になる、という痛いパターンが語られます。DB フェイルオーバのように扱い——エージェントを介さない帯域外シェルから実行するか、プレイブックが許すならより安全な launchctl kickstart -k パターンを使ってください。
タイムゾーン、DST、ログ相関
cron が夏時間の境をまたぐと、UTC オフセットが一定だと仮定したダッシュボードは静かに嘘をつきます。SIEM には UTC を標準で積み、各行にジョブが宣言した IANA ゾーンを載せましょう。東京と米東岸では「現地 9 時」が 11〜14 時間 ずれる——ランブックに書かないと当直が幽霊遅延を追いかけます。
実務的テレメトリ：完了イベントごとに 3 つ の時刻を付ける——Mac の壁時計、UTC、cron 設定ゾーン——と、NTP 揺らぎ後の手動時計ずれで「二重実行」パニックを切り分けやすくなります。共有 MacLogin ホストではメンテで定期的に sntp -sS を確認してください。120 ms でも単純ソートの集中ビューでは行順が入れ替わります。
Webhook をばら撒くジョブなら、ペイロードに単調増加カウンタを入れて受信側が openclaw cron run の再実行時に二重計上を落とせるようにする——金融ボットの二重請求に比べれば安い保険です。
OpenClaw Cron FAQ
容量の近道：ジョブの壁時計がルーチンで 8 分 を超えるなら、小さなターンに分割するか CPU 重い処理は専用ホストへ——さもなくば同一ゲートウェイ上のチャット遅延が悪化します。
Webhook に cron は投稿できる？ ビルドによって配信モードが異なります。本番依存の前にバージョンで検証してください。
Docker は？ macOS ベアメタルではゲートウェイをコンテナ化しないことが多いです。セキュリティが強制しない限りネイティブ launchd を推します。
容量を増やすには？ 料金ページ でプランを比較し、隔離契約が要る顧客ごとにスケジューラを分けてください。
財務は cron 定義を見るべき？ Terraform と同様に：秘密は伏せつつ、名前・オーナー・スケジュールは開示し、コストレビューに自動化オーバーヘッドを含めます。
スケジュールされたエージェントに Mac mini M4 が合う理由
Apple Silicon Mac mini M4 は常時稼働ゲートウェイに熱挙動が読みやすく、cron が引き起こす 90 秒 ほどの CPU スパイクでもノートのようなスロットリングに陥りにくいです。統合メモリは、cron 取り込みでベクトル索引再構築が走っても対話チャットと同居しやすい余裕を与えます。
MacLogin は香港・日本・韓国・シンガポール・米国で専用ハードを運用しています。ジョブが触るデータの近くにスケジューラを置き、SSH／VNC 手順は文書化し、cron 定義は顧客データに触り得る他の自動化と同様にインフラコードとしてレビューしてください。
