Multiple Gateways
1 台のホストで複数の OpenClaw Gateway を実行(分離、ポート、プロファイル)。
ほとんどの設定では、単一のゲートウェイを使用する必要があります。単一のゲートウェイは複数のメッセージ接続とエージェントを処理できるためです。より強力な分離または冗長性(レスキューボットなど)が必要な場合は、分離されたプロファイル/ポートを持つ別のゲートウェイを実行してください。
分離チェックリスト(必須)
- ''OPENCLAW_CONFIG_PATH'' — インスタンスごとの設定ファイル
- ''OPENCLAW_STATE_DIR'' — インスタンスごとのセッション、クレジット、キャッシュ
- ''agents.defaults.workspace'' — インスタンスごとのワークスペースルート
- ''gateway.port'' (または ''--port'') — インスタンスごとに一意
- 派生ポート(ブラウザ/キャンバス)は重複してはいけません
これらが共有されている場合、設定の競合とポートの競合が発生します。
推奨:プロファイル (`--profile`)
プロファイルは自動的に ''OPENCLAW_STATE_DIR'' + ''OPENCLAW_CONFIG_PATH'' をスコープし、サービス名をサフィックスします。
openclaw --profile main setup openclaw --profile main gateway --port 18789 openclaw --profile rescue setup openclaw --profile rescue gateway --port 19001
プロファイルごとのサービス:
openclaw --profile main gateway install openclaw --profile rescue gateway install
レスキューボットガイド
同じホストで独自のものを持つ 2 番目のゲートウェイを実行します:
- プロファイル/設定
- 状態ディレクトリ
- ワークスペース
- ベースポート(プラス派生ポート)
これにより、レスキューボットがメインボットから分離され、メインボットがダウンしたときにデバッグや設定の変更を適用できます。
ポート間隔:派生されたブラウザ/キャンバス/CDP ポートが競合しないように、ベースポートの間に少なくとも 20 のポートを保持します。
#
インストール方法(レスキューボット)
openclaw onboard openclaw gateway install openclaw --profile rescue onboard openclaw --profile rescue gateway install
ポートマッピング(派生)
ベースポート = ''gateway.port''(または ''OPENCLAW_GATEWAY_PORT'' / ''--port'')。
- ブラウザ制御サービスポート = base + 2(ループバックのみ)
- ''canvasHost.port = base + 4''
- ブラウザプロファイル CDP ポートは ''browser.controlPort + 9 .. + 108'' から自動的に割り当てられます
設定または環境変数でこれらのいずれかを上書きする場合、インスタンスごとに一意に保つ必要があります。
ブラウザ/CDP ノート(一般的な落とし穴)
- 複数のインスタンスで ''browser.cdpUrl'' を同じ値にハードコード''しないでください''。
- 各インスタンスは、独自のブラウザ制御ポートと CDP 範囲(ゲートウェイポートから派生)が必要です。
- 明示的な CDP ポートが必要な場合は、各インスタンスで ''browser.profiles.'' を設定します。
- リモート Chrome:''browser.profiles.'' を使用します(プロファイルごと、インスタンスごと)。
手動環境変数の例
OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \ OPENCLAW_STATE_DIR=~/.openclaw-main \ openclaw gateway --port 18789 OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \ OPENCLAW_STATE_DIR=~/.openclaw-rescue \ openclaw gateway --port 19001
クイックチェック
openclaw --profile main status openclaw --profile rescue status openclaw --profile rescue browser status