2026 MacLogin クラウド Mac における OpenClaw Gateway のグレースフルシャットダウン：ウェブフックキュー排出、launchd の順序付け、パートナー安全な再起動
オペレーターは launchctl kill が好きです— Stripe のウェブフックが二重に飛び、経理がエスカレートするまで。 2026年4月時点で MacLogin Apple Silicon（香港・東京・ソウル・シンガポール・米国）の OpenClaw Gateway に対する姿勢はこうです：停止はトラフィック工学の問題として扱う—イングレスを止め、キューを排出または永続化し、メトリクスで空であることを証明してから launchd に信号する。 本プレイブックは爆発半径、排出ノブのマトリクス、リバースプロキシの順序ルール、九つの具体ステップ、再試行の経済性、可観測性シグナル、重複排除・カットオーバーへのリンク、FAQ、多地域現実に根ざした Mac mini の結論を扱います。
拡張として ウェブフック重複排除、本番カットオーバー時のヘルスチェック、launchd の kickstart リロード を読んでください。アンカー：ヘルプ、料金、VNC、OpenClaw トピックハブ。
ハードストップがウェブフックを複製する理由（dedup ストアを焼く）
ゲートウェイをバッチ途中で殺すと結果が半書きのまま残ります：パートナーは HTTP 502 を受け、SDK が指数バックオフで再試行し、重複排除テーブルはビジネスイベントは同じなのに新しい ID を見ます。2026年3〜4月のパイロットでチームが測った三つのコスト：
- サポート負荷： 排出窓を飛ばすと CRM の二重行がチケットを約 18% 増やしました。
- LLM 支出： リプレイがツール呼び出しを再トリガーし、混雑テナントでは複製された自動化トレースあたりおよそ $0.11。
- コンプライアンス： SOC2 CC7.2 のサンプリングは停止が統制された証拠を求めます—無計画な kill は監査より速く落ちます。
排出ノブマトリクス（イングレス対キュー対プロセス）
| 層 | 止めるもの | 排出成功のシグナル | よくある間違い |
|---|---|---|---|
| TLS リバースプロキシ | 新規接続 | 60 秒間フライト中リクエストゼロ | ヘルスチェックを残す—LB が合成 POST を送り続ける |
| ゲートウェイ HTTP | accept ループ | 深さゲージが二回ゼロ | タスクが JSON を直列化しているのに 200 OK を信じる |
| アウトバウンドディスパッチャ | ワーカースレッド | パートナーダッシュボードで再試行が静か | cron を同時に止める—cron が背後で仕事を積む |
| 永続状態 | ディスク fsync | 前後でチェックサム一致 | バックアップ指針どおり ~/.openclaw のスナップショットを飛ばす |
launchctl unload と openclaw gateway stop（順序）
人間がオンラインなら CLI の停止経路を使ってください—SIEM がパースできる構造化ログを出します。plist のチェックサムを既に取得した破断自動化向けに素の launchctl unload を取っておきます。バウンスする LaunchAgent と同じ SSH セッションから操作しないでください；リロード運用ブックのガードレールと同様に、自分を孤立させないためです。
九段階メンテナンス運用ブック（変更チケットにコピー）
- 通告：メンテナンストークンを宣言し、ゲートウェイ設定の編集を 30 分凍結。
- スナップショット：状態バックアップ指針 に従い OpenClaw の状態ディレクトリを。
- 一時停止：インバウンド TLS リスナーを止めるかプロキシをメンテナンスモードに—合成 curl が 503 を期待することを確認。
- 排出：アウトバウンドウェブフックキューが深さ 0 を連続二回の 15 秒観測で維持するまで。
- 停止：排出中に新規作業を積む cron／チャットトリガーを止めた後、逆順で再開。
- 呼び出し：グレースフル停止 CLI（推奨）を実行し、終了コード 0 をチケットに記録。
- 検証：ループバックポート 18789 が標準のソケットチェックで解放されたことを確認。
- 適用：リロード前にメンテナンス（バイナリ更新、plist、newsyslog）。
- 再開：ローカルとバスティオンの両方からヘルスプローブが 120 秒連続成功してからイングレスを戻す。
再試行嵐の予算（排出がお金を救う理由）
各リプレイが上流 LLM 呼び出し 2 回（各 $0.006）と可観測性ベンダーのウェブフック配信 3 回（各 $0.0009）を引き起こすと仮定します。月一万の偶発リプレイだけで LLM 料金がおよそ $156—人間のトリアージの前です。現場メモでは APAC 優先テナントで測定された排出がリプレイ数を 62% 削りました。
電源を切る前に「緑・排出済み」を証明するメトリクス
- キュー深さゲージ がゼロで、45 秒間微分がフラット。
- パートナー宛アウトバウンド HTTP 2xx 比率 が排出末尾で ≥ 99.2%—下がったら窓を延長。
- CPU softirq が 90 秒以内にベースラインへ—スパイクが残ると隠れたワーカースレッドがいます。
クロスリンク：重複排除、カットオーバー、レート制限
停止訓練を プロバイダレート制限 と組み合わせ、再起動後のゲートウェイがバックオフを守るようにしてください。複数ゲートウェイがある場合は dedup キー指針 に沿ってストレージを揃えてから、カットオーバー運用ブック に記載の DNS 重みを振ります。
| パートナー HTTP の振る舞い | 排出への含意 | アクション |
|---|---|---|
| 5 秒クライアントタイムアウト、自動再試行 3 回 | 末尾レイテンシの表面が短い | 排出を +60 秒延長するかイングレスを早めに止める |
| 安定ボディハッシュのべき等 POST | リプレイに強い | メトリクスがゼロキューを確認すれば排出を短縮できる |
| ローテーション鍵でウェブフック署名 | 再起動で署名キャッシュが壊れることがある | イングレスを開く前にトラストストアをリロード |
FAQ
MacLogin が排出を代行しますか？ 運用ブックは御社組織に残ります；インフラと ヘルプ へのパスを提供します。
パートナーが Retry-After を無視したら？ 自社のアウトバウンドログが静かになるまで排出し続けてください—例外はチケットに記録します。
キャパシティはどこに足しますか？ 一つの熱エンベロープにゲートウェイを積む前に 料金 でリージョンを比較してください。
グレースフル排出に Mac mini M4 がまだ合う理由
M4 の効率は排出末尾を短くします：統合メモリによりウェブフックのシリアライズバッファとモデルキャッシュを同時に抱えても Intel ミニで排出が伸びたような NVMe スラッシュがありません。多地域チームは東京と米国の専用ノードを MacLogin で借り、メンテナンス窓が人の稼働と重なるようにします—Apple Silicon は 24/7 エージェント向けに Mac Pro タワーを運ぶよりワットあたりのゲートウェイ数が低いままです。
停止規律がルーティンになったら、無限のシェルワンライナーではなく 料金 経由の余剰キャパシティに投資してください；経理が二重請求書を数えるとき、ハードウェア並列のほうが勝ちます。
