レスキューボットのクイックスタート
最もシンプルなレスキューボットのセットアップ:- メインボットはデフォルトプロファイルのままにします。
- レスキューボットは
--profile rescueで実行し、専用の Telegram ボットトークンを使います。 - レスキューボットには別のベースポートを割り当てます。例:
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 に専用の名前付きプロファイルとベースポートを割り当てます。分離チェックリスト
Gateway インスタンスごとに、これらを一意に保ってください。| 設定 | 目的 |
|---|---|
OPENCLAW_CONFIG_PATH | インスタンスごとの設定ファイル |
OPENCLAW_STATE_DIR | インスタンスごとのセッション、認証情報、キャッシュ |
agents.defaults.workspace | インスタンスごとのワークスペースルート |
gateway.port（または --port） | インスタンスごとに一意 |
| 派生ブラウザー/CDP ポート | 下記を参照 |
ポートマッピング（派生）
ベースポート =gateway.port（または OPENCLAW_GATEWAY_PORT / --port）。
- ブラウザー制御サービスのポート = ベース + 2（loopback のみ）。
- 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を使います（プロファイルごと、インスタンスごと）。
手動 env の例
クイックチェック
gateway status --deepは、古いインストールから残った launchd/systemd/schtasks サービスを検出します。multiple reachable gateway identities detectedのようなgateway probeの警告テキストは、意図的に分離された Gateway を複数実行している場合、または到達可能なプローブ対象が同じ Gateway であることを OpenClaw が証明できない場合にのみ想定されます。同じ Gateway への SSH トンネル、プロキシ URL、または設定済みリモート URL は、トランスポートポートが異なっていても、複数のトランスポートを持つ 1 つの Gateway です。