OpenClaw Gateway設定ガイド：接続と運用を最適化する

開発を進めていると、複数のプロセス間での通信やセッション管理が複雑になりがちですよね。「どのプロセスが接続を維持すべきか」「セキュリティはどう担保するか」といった悩みは、多くの開発者が直面する課題です。

今回は、OpenClawのネットワークモデルを整理して、スムーズな開発環境を構築するためのポイントを見ていきましょう。

ネットワークモデル

このコンテンツは Network に統合されました。最新のガイドについては、そちらのページを参照してください。

ほとんどの操作は、Gateway (openclaw gateway) を介して行われます。これは、チャネル接続と WebSocket コントロールプレーンを管理する、単一の常駐プロセスです。

基本ルール

• ホストごとに 1 つの Gateway を実行することを推奨します。WhatsApp Web セッションを所有できるのは、このプロセスだけです。レスキュー用ボットの運用や厳格な分離が必要な場合は、プロファイルとポートを分離した状態で複数の Gateway を実行してください。詳細は Multiple gateways を参照してください。
• ローカルループバックを優先します。Gateway の WS はデフォルトで ws://127.0.0.1:18789 に設定されています。セットアップウィザードは、ループバック接続であってもデフォルトで Gateway トークンを生成します。Tailnet 経由でアクセスする場合は、openclaw gateway --bind tailnet --token ... を実行してください。ループバック以外でバインドする場合、トークンが必須となります。
• Node は、必要に応じて LAN、Tailnet、または SSH を介して Gateway の WS に接続します。レガシーな TCP ブリッジは非推奨となりました。
• Canvas ホストは、Gateway の HTTP サーバーによって Gateway と同じポート（デフォルトは 18789）で提供されます：
  • /__openclaw__/canvas/
  • /__openclaw__/a2ui/ gateway.auth が設定され、Gateway がループバック以外にバインドされている場合、これらのルートは Gateway 認証によって保護されます。Node クライアントは、アクティブな WS セッションに紐づいた Node スコープの Capability URL を使用します。詳細は Gateway configuration (canvasHost, gateway) を参照してください。
• リモートでの利用は、通常 SSH トンネルまたは Tailnet VPN を使用します。詳細は Remote access および Discovery を確認してください。

次のステップ

• Gateway の設定
• リモートアクセス
• マルチ Gateway の運用

設定で困ったことがあれば、AI Setup Assistant に相談してみてください。