2026 OpenClaw Gateway
ホットリロードとリモート複数インスタンス

Gateway は単一の Node プロセスが既定 18789 のリスナー一本で WebSocket、CLI の RPC、セッション、チャネルアダプタを多重化します。ホットリロードは差分設定をマージしつつセッション維持を狙いますが、リスニングソケットを解体しなければならない変更はプロセス内合成では代替できません。TLS 終端の素材、ループバックから LAN への露出クラス移行、ポート衝突、匿名管理面を晒しかねない認証ハードゲートは、計画的な再起動の類です。ハイブリッドの再読み込みモードは、オンライン合成を許すフィールドの許可リストと再起動必須フラグを内蔵しますが pre-1.0 の速度ではリリースごとに分岐が動きますから、静的な覚え書きよりライブログを正とする運用が安全です。

以下の五つは再読み込み不具合に見えがちですが、多くはカテゴリ誤認か参照先のズレです。

切り分け順は、編集がソケット接触かルーティングのみかを分類し、リモート配線と環境変数を検証し、最後にデーモン健全性へ戻ります。インストールから doctor までを網羅した完整ガイドは本ブログの別稿へ譲り、本稿は再読み込みと並列インスタンスに寄せます。

ステージングと本番が混ざる現場ではチケット番号付きで設定スナップショットをアーカイブしてください。git diff の規律が真夜中の当て推量より速く済みます。

運用テレメトリでも示唆は同じです。gateway ブロックに触るマージ帯だけ CLI の中央値遅延が跳ねるなら、CPU 枯渇より再起動署名の見落としが濃厚です。リリース時刻とチャネルミュート事件を相関させると、バウンスを省いたせいで上流には届いたのにモデルルーティングへ届かない灰色障害が引き伸ばされる様子が見えます。ジュニア担当者にログ grep で署名を探させる投資は、フリート全体の CPU 余裕を拡げるより返りが早いことが多いです。

どの自動化アカウントが再読み込み敏感ツールを叩けるかも文書化してください。CI が素朴なテンプレで JSON を書き換えると尾 comma や重複キーでパーサが黙って拒否し、再起動まで気づかないケースを再読み込み欠陥と誤認しがちです。CI にスキーマ検証を載せれば人間とロボットの編集が揃います。

障害訓練では、バックアップから戻す手順をロール名つきでリハーサルし、誰がプローブし誰が顧客連絡かを15分以内に固定できるかを測ります。ドリルは動画不要で、時系列のテキストだけでも十分です。

揮発的なフィールド名を暗記するより、トランスポート階級で判断を固定します。リスナー、TLS、認証結合はカーネル向き境界に触れるため計画再起動側です。ルーティング方針、多くのチャネルパラメータ、モデルルーティング実験、フォーマット調整はオンライン合成の側に寄りがちです。常に Gateway ログで適用成功か再起動必須かを確認してください。公開露出はリバースプロキシの WebSocket アップグレードとトークン輪番を後述の VPS 記事と同期させる必要があります。

ファイアウォール、NGINX や Caddy 断片、クラウドセキュリティグループは本サイトの公開 Gateway プレイブックに委ねます。ベンダ改题で腐るスクショの複製は避けます。

ゲームデイ演習では、合成トラフィック中に意図的に再起動必須フィールドを切り替え、認知平均時間とチャネル ACK 回復平均時間を測ります。 muscle memory が映像より重要です。演習後は所見を一ページにまとめ、次回のマージ方針レビューに回してください。

リモートモードは日々の CLI を流すマシンとチャネルとセッションを持つマシンを切り離します。ノート PC はクラウド WebSocket 終端を指す薄い設定と、シェル履歴ではなく環境変数へ流し込む秘密を保ちます。ステージング並列は三層の隔離が要ります。ポート、OPENCLAW_HOME ツリー、ログラベルです。インシデント中に stderr を取り違えないことが支援コストを下げます。

ホスト A 本番:
  OPENCLAW_GATEWAY_PORT=18789
  OPENCLAW_HOME=/var/openclaw/prod-a

ホスト B ステージング:
  OPENCLAW_GATEWAY_PORT=18790
  OPENCLAW_HOME=/var/openclaw/staging-b

ノート PC CLI:
  gateway.remote.url=wss://gateway.example.com/openclaw
  gateway.remote.token=${OPENCLAW_REMOTE_TOKEN}

各アップグレード後は remote 関連キーを diff してください。pre-1.0 はデフォルト順が頻繁に入れ替わります。クラウド Mac では再読み込みとは別に LaunchAgent の起床挙動を検証してください。スリープ起因の切断はマージ失敗に扮します。

リバースプロキシがあると URL が複層になります。エッジで TLS を終端するなら CLI は wss を見て内側 hop は localhost の ws のままかもしれません。公開クライアント URL、内側上流 URL、ヘルス用 curl の三つを明示し、ダッシュボードは緑なのに CLI は握手で落ちる分裂を防いでください。アイドルタイムアウトは最長の cron 駆動バーストより長くし、中間が無音区間を切らないようにします。

ブルーグリーン実験で二台走らせるならトークンも独立して輪番してください。漏洩したステージ秘密が本番チャネルを解錠しないようにします。並列環境は記憶の抜けを増幅するため、輪番リマインダを自動化します。

各ステップに責任ロールを注釈し、プラットフォームとアプリ所有者の誰がプローブし誰が顧客連絡かを明確にします。障害十五分目の混乱は単一ポートの typo より壁時計を食います。

軽量チェックリストは寝不足の即興ヒロイズムに勝ちます。チェックリストはリリースカレンダーとリンクし、承認者二名とバックアウト条件を同じ表に置くと迷いが減ります。

再読み込み契約を理解せずに Gateway を捨てコンテナ扱いするとトラフィックピークのインシデント時間が燃えます。規律ある設定マージと安定ホストを組み合わせると OpenClaw はラップトップ玩具ではなくインフラになります。MESHLAUNCH の Mac mini クラウド賃借は、Apple Silicon 排他性、復旧しやすい電源、シンガポール・東京・ソウル・香港・米東・米西で伸縮するリースが同梱され、週末を蓋開け Mac に賭けない変更窓と相性が良い場面が多いです。

財務側は再読み込み誤認が垂直スケール浪費を誘発することを嫌います。ログでインシデントがソケット攪拌と相関するか証明し、否なら予算をネットワーク明瞭化やステージ二台に振り、アイドルしがちな巨大 CPU に流しません。