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

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

最も簡単なレスキューボットのセットアップ:
  • メインボットはデフォルトプロファイルのままにします。
  • レスキューボットは、独自の Telegram ボットトークンを使用して --profile rescue で実行します。
  • レスキューボットには別のベースポート（例: 19789）を設定します。
これにより、プライマリボットが停止していても、レスキューボットでデバッグや設定変更を行えます。派生するブラウザ/CDP ポートが衝突しないように、ベースポート間には少なくとも 20 ポートの間隔を空けてください。
メインボットがすでに実行中であれば、通常はこれだけで十分です。オンボーディングですでにレスキューサービスがインストールされている場合は、最後の gateway install を省略してください。 openclaw --profile rescue onboard の実行中:
  • レスキューアカウント専用の別の Telegram ボットトークンを使用します（オペレーター専用に保ちやすく、メインボットのチャンネル/アプリのインストールから独立し、DM ベースの簡単な復旧経路になります）。
  • rescue というプロファイル名を維持します。
  • メインボットより少なくとも 20 大きいベースポートを使用します。
  • 自分ですでに管理しているワークスペースがない限り、デフォルトのレスキューワークスペースを使用します。

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

--profile rescue onboard は通常のオンボーディングフローを実行しますが、すべてを別のプロファイルに書き込むため、レスキューボットには次のものが個別に作成されます:
  • プロファイル/設定ファイル
  • 状態ディレクトリ
  • ワークスペース（デフォルト: ~/.openclaw/workspace-rescue）
  • 管理対象サービス名
  • ベースポート（および派生ポート）
  • Telegram ボットトークン
それ以外のプロンプトは通常のオンボーディングと同じです。

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

同じ分離パターンは、1 台のホスト上の任意の Gateway の組み合わせやグループに使用できます。追加する各 Gateway に、固有の名前付きプロファイルとベースポートを割り当てます:
両方で名前付きプロファイルを使用することもできます:
サービスも同じパターンに従います:
フォールバック用のオペレーター経路にはレスキューボットのクイックスタートを使用し、異なるチャンネル、テナント、ワークスペース、または運用ロールにまたがる複数の常駐 Gateway には一般的なプロファイルパターンを使用してください。

​
分離チェックリスト

Gateway インスタンスごとに、以下を一意にしてください: これらのいずれかを共有すると、設定、状態、またはポートの競合が発生します。 OPENCLAW_ALLOW_MULTI_GATEWAY=1 によって設定ごとの単一インスタンス制約がスキップされる場合でも、Gateway の起動時には状態ディレクトリの所有権が一意であることが強制されます。

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

ベースポート = gateway.port（または OPENCLAW_GATEWAY_PORT / --port）。
  • ブラウザ制御サービスのポート = ベース + 2（local loopback のみ）。
  • Canvas ホストは Gateway HTTP サーバー自体（gateway.port と同じポート）で提供されます。
  • ブラウザプロファイルの CDP ポートは、browser control port + 9 から + 108 の範囲で自動的に割り当てられます。
これらを設定または環境変数で上書きする場合は、インスタンスごとに一意にする必要があります。

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

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

​
手動での環境変数設定例

​
簡易チェック

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

​
関連項目