本番OpenClawゲートウェイはネイティブ macOS上で長寿命WebSocketセッションを抱える時間がワンショット REST より長い——それでもチームは HTTP タイムアウトだけを調整しデプロイ時にチャットクライアントがフラップする理由を不思議がる。本2026-05-08マトリックスは入口制限、インフライトバックプレッシャー、再接続方針を一つの契約として扱う：hello で上限を通知し匿名バーストを抑え、再接続ループにジッターを入れて自動化クライアントの群れが障害を再生しないようにする。2 表、JSON-LD の 8 ステップ、FAQ、分割入口と可観測性へのリンクで、オペレータはApple Silicon M4の CPU だけでなくキュー深度を見られる。
ループバック対パブリック入口分割と組み合わせ、ゲートウェイ認証とツールレート制限の認証済み invoke スロットルと比較し、ゲートウェイ可観測性とマスキングでログを正直に保ちリトライが特権ペイロードを隠さないようにする。
WebSocket 嵐の間に CPU アイドルグラフが嘘をつく理由
Apple Siliconのユニファイドメモリは CPU 利用率を穏やかに保ちつつ、接続テーブル、TLS セッション、フレームパーサがモデル呼び出しと同じコアを争う。Mac mini M4ゲートウェイが CI レーンと同居すると、アップロードバーストとシミュレータの回転が CPU ゲージを動かさず PCIe/NIC の注意を奪う——ボトルネックがソケット縁の准入制御であるときにクライアントが「モデル遅延」を感じるのはまさにそのときだ。
- 対称再接続の群れ：ジッターが整列を壊さない限りクライアントは cron とリトライ周期を共有する。
- 匿名入口：パスを分割しない限り webhook やチャットブリッジは信頼済み自動化と同じリスナー族を叩く。
- 隠れたキュー：サーバーは TCP を受け入れアプリケーションキューが膨らむ——ドロップが始まるまでライブネスプローブは緑のまま。
設計チェックポイント：通知された上限は hello ハンドシェイクに属する——429 JSON だけから上限を知るクライアントでは流量を責任をもって整形するには遅すぎる。
マトリックス A — ポリシー面 vs 運用の前提 vs 検証習慣
| ポリシー面 | よくある前提 | 検証方法 |
|---|---|---|
| 接続ごとのフレームウィンドウ | 「クライアントは丁寧に自己抑制する」 | 攻撃的な自動化で負荷試験；ハードクローズ前に警告を期待。 |
| インフライトキュー深度 | TCP を受け入れれば健全 | キュー深度メトリクスをエクスポート；接続クラスごとに保留フレームが 64 を超えたらアラート。 |
| 再接続バックオフ方針 | 固定 5 秒リトライで十分 | 制御ゲートウェイ再起動ドリル後の再接続衝突を測定。 |
マトリックス B — 故障モード vs シグナル vs 緩和オーナー
| 故障モード | シグナル | 緩和 |
|---|---|---|
| サンダリング再接続の群れ | ログに対称な切断スパイク | ジッター係数を 0.35 に上げる；IP あたり最大同時セッションを一時的に半分に。 |
| CPU 上昇なしのキュー増加 | 遅延が伸び CPU < 40% | 匿名パスでバックプレッシャードロップを有効化；管理トラフィックをループバックリスナーへ。 |
| リリース間のポリシードリフト | クライアントが不一致な hello 上限を見る | ゲートウェイ semver を固定；再起動前に設定検証；semver をランブックに記載。 |
建設的に議論できる数値デフォルト
- 再接続基底遅延：2 秒から開始、指数係数 2×、上限 60 秒、ジッター幅 ±35%。
- フレーム予算：ピーク時チャット自動化で認証済みセッションあたり10 秒に100アプリメッセージと仮定——測定 p99 で調整。
- インシデント SLA：5 分間セッションの15%超で切断率が続く場合、モデルプロバイダを責める前にゲートウェイオーナーへページ。
8 つのロールアウトステップ（JSON-LD と対応）
- 上限を通知——リスナークラスごとの hello で。
- 認証前を抑制——接続試行にスライディングウィンドウ。
- インフライトを境界——明示的ドロップまたは一時停止セマンティクスで。
- 再接続を調整——自動化フリート全体にジッター付きバックオフ。
- 入口を分割——管理パスが匿名競合を避けるように。
- 構造化ログ——相関 ID 付きイベント。
- 歪みでアラート——受理率と処理率の間。
- 四半期レビュー——ベンダー上限とクライアント成長に対して。
FAQ
WebSocket 入口が厳しくても HTTP レート制限は必要か？
はい——別表面；攻撃者やバグのあるクライアントはソケットが良くても REST invoke を乱用できる。
ゲートウェイは重度 CI と同一 Mac で動かすべきか？
cgroup クラスによるスケジューリング規律がある場合のみ；本番チャットゲートウェイは隔離ホストまたは厳密 CPU ピニングに値する——NodeMac リージョンはサプライズ遅延より隔離を安くする。
中国香港、日本、韓国、シンガポール、アメリカでレンタル Mac mini M4容量上でOpenClawを運用すると、チャット入口実験と CI アップロードを分離できる——両方ともネットワークを押すが方針は異なる。Apple Siliconの効率より准入の正直さが重要；SSH自動化とオプションVNCは macOS が無人復旧をブロックするときの同意プロンプトを解決する。物理専用ノードは共有ノート PC と比べて騒がしい隣人の話を減らし、上記マトリックスは WebSocket 挙動を「モデルが遅い」伝説ではなく測定可能な SLO に変える。