OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Gateway

複数の Gateway

多くのセットアップでは Gateway は1つで十分です。1つの Gateway で複数のメッセージング接続とエージェントを処理できます。より強力な分離や冗長性が必要な場合（例: レスキューボット）に限り、プロファイルとポートを分離した複数の Gateway を実行してください。

レスキューボットのクイックスタート

最もシンプルなレスキューボットのセットアップ:

  • メインボットではデフォルトプロファイルを使用します。
  • レスキューボットは、専用の Telegram ボットトークンを使用して --profile rescue で実行します。
  • レスキューボットには別のベースポート（例: 19789）を指定します。

これにより、プライマリボットが停止している場合でも、レスキューボットでデバッグや設定変更を行えます。派生するブラウザー/CDP ポートが衝突しないよう、ベースポート間は少なくとも20ポート空けてください。

bash
# レスキューボット（別の Telegram ボット、別のプロファイル、ポート19789）openclaw --profile rescue onboardopenclaw --profile rescue gateway install --port 19789

メインボットがすでに実行中であれば、通常はこれだけで十分です。オンボーディングですでにレスキューサービスがインストールされている場合は、最後の gateway install を省略してください。

openclaw --profile rescue onboard の実行中:

  • レスキューアカウント専用の別の Telegram ボットトークンを使用します（オペレーター専用にしやすく、メインボットのチャンネル/アプリのインストールから独立しており、DM ベースのシンプルな復旧経路になります）。
  • プロファイル名は rescue のままにします。
  • メインボットより少なくとも20大きいベースポートを使用します。
  • すでに独自に管理しているワークスペースがない限り、デフォルトのレスキューワークスペースを使用します。

--profile rescue onboard による変更内容

--profile rescue onboard は通常のオンボーディングフローを実行しますが、すべてを別のプロファイルに書き込むため、レスキューボットには次のものが個別に用意されます。

  • プロファイル/設定ファイル
  • 状態ディレクトリ
  • ワークスペース（デフォルト: ~/.openclaw/workspace-rescue）
  • 管理対象サービス名
  • ベースポート（および派生ポート）
  • Telegram ボットトークン

それ以外のプロンプトは通常のオンボーディングと同じです。

一般的な複数 Gateway のセットアップ

同じ分離パターンは、1台のホスト上にある任意の2つ以上の Gateway に適用できます。追加する各 Gateway に、固有の名前付きプロファイルとベースポートを指定します。

bash
# メイン（デフォルトプロファイル）openclaw setupopenclaw gateway --port 18789 # 追加の Gatewayopenclaw --profile ops setupopenclaw --profile ops gateway --port 19789

両方で名前付きプロファイルを使用することもできます。

bash
openclaw --profile main setupopenclaw --profile main gateway --port 18789 openclaw --profile ops setupopenclaw --profile ops gateway --port 19789

サービスでも同じパターンを使用します。

bash
openclaw gateway installopenclaw --profile ops gateway install --port 19789

フォールバック用のオペレーター経路にはレスキューボットのクイックスタートを使用し、異なるチャンネル、テナント、ワークスペース、または運用上の役割にまたがって複数の Gateway を長期運用する場合は、一般的なプロファイルパターンを使用してください。

分離チェックリスト

Gateway インスタンスごとに、次の項目を固有にしてください。

設定 目的
OPENCLAW_CONFIG_PATH インスタンスごとの設定ファイル
OPENCLAW_STATE_DIR インスタンスごとのセッション、認証情報、キャッシュ
agents.defaults.workspace インスタンスごとのワークスペースルート
gateway.port（または --port） インスタンスごとに固有
派生するブラウザー/CDP ポート 下記を参照

これらのいずれかを共有すると、設定の競合やポートの衝突が発生します。

ポートマッピング（派生）

ベースポート = gateway.port（または OPENCLAW_GATEWAY_PORT / --port）。

  • ブラウザー制御サービスのポート = ベース + 2（ループバックのみ）。
  • Canvas ホストは Gateway の HTTP サーバー自体で提供されます（gateway.port と同じポート）。
  • ブラウザープロファイルの CDP ポートは、browser control port + 9 から + 108 の範囲で自動的に割り当てられます。

これらを設定または環境変数で上書きする場合は、インスタンスごとに固有の値を指定する必要があります。

ブラウザー/CDP に関する注意事項（よくある落とし穴）

  • 複数のインスタンスで browser.cdpUrl を同じ値に固定してはなりません。
  • 各インスタンスには、固有のブラウザー制御ポートと CDP 範囲（Gateway ポートから派生）が必要です。
  • CDP ポートを明示的に指定する場合は、インスタンスごとに browser.profiles.<name>.cdpPort を設定します。
  • リモート Chrome の場合は、browser.profiles.<name>.cdpUrl を使用します（プロファイルごと、インスタンスごと）。

手動での環境変数設定例

bash
OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \OPENCLAW_STATE_DIR=~/.openclaw \openclaw gateway --port 18789 OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \OPENCLAW_STATE_DIR=~/.openclaw-rescue \openclaw gateway --port 19789

クイックチェック

bash
openclaw gateway status --deepopenclaw --profile rescue gateway status --deepopenclaw --profile rescue gateway probeopenclaw statusopenclaw --profile rescue statusopenclaw --profile rescue browser status
  • gateway status --deep は、古いインストールに由来する残存した launchd/systemd/schtasks サービスを検出します。
  • multiple reachable gateway identities detected のような gateway probe の警告テキストが想定されるのは、複数の分離された Gateway を意図的に実行している場合、または到達可能なプローブ対象が同じ Gateway であることを OpenClaw が確認できない場合のみです。同じ Gateway への SSH トンネル、プロキシ URL、または設定済みのリモート URL は、転送ポートが異なる場合でも、複数の転送経路を持つ1つの Gateway です。

関連項目

Was this useful?
On this page

On this page