多個閘道

大多數設定只需要一個閘道——單一閘道可處理多個訊息連線和代理程式。只有在需要更強的隔離或備援時（例如救援機器人），才使用隔離的設定檔／連接埠執行個別閘道。

救援機器人快速入門

最簡單的救援機器人設定：

• 讓主要機器人使用預設設定檔。
• 使用 --profile rescue 執行救援機器人，並為其使用獨立的 Telegram 機器人權杖。
• 為救援機器人使用不同的基礎連接埠，例如 19789。

如此一來，即使主要機器人停止運作，救援機器人仍可進行偵錯或套用設定變更。基礎連接埠之間至少保留 20 個連接埠，確保衍生的瀏覽器／CDP 連接埠不會發生衝突。

# 救援機器人（獨立的 Telegram 機器人、獨立的設定檔、連接埠 19789）openclaw --profile rescue onboardopenclaw --profile rescue gateway install --port 19789

如果主要機器人已在執行，通常只需完成上述步驟。如果初始設定已安裝救援服務，請略過最後的 gateway install。

進行 openclaw --profile rescue onboard 時：

• 使用專供救援帳號使用的獨立 Telegram 機器人權杖（可輕鬆限制為僅供操作員使用、獨立於主要機器人的頻道／應用程式安裝，並提供簡單的私訊式復原途徑）。
• 保留 rescue 設定檔名稱。
• 使用至少比主要機器人高 20 的基礎連接埠。
• 除非你已自行管理工作區，否則接受預設的救援工作區。

--profile rescue onboard 會變更的內容

--profile rescue onboard 會執行一般初始設定流程，但將所有內容寫入獨立的設定檔，因此救援機器人會擁有自己的：

• 設定檔／設定檔案
• 狀態目錄
• 工作區（預設：~/.openclaw/workspace-rescue）
• 受管理的服務名稱
• 基礎連接埠（以及衍生連接埠）
• Telegram 機器人權杖

除此之外，提示與一般初始設定相同。

一般多閘道設定

相同的隔離模式適用於同一主機上的任意一組或多組閘道——為每個額外閘道分別指定具名設定檔和基礎連接埠：

# 主要閘道（預設設定檔）openclaw setupopenclaw gateway --port 18789 # 額外閘道openclaw --profile ops setupopenclaw --profile ops gateway --port 19789

兩邊都使用具名設定檔也可以：

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

服務也遵循相同模式：

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

使用救援機器人快速入門來建立備用的操作員管道；若要讓多個長期運作的閘道分別用於不同的頻道、租用戶、工作區或營運角色，請使用一般設定檔模式。

隔離檢查清單

每個閘道執行個體的下列項目都必須保持唯一：

共用其中任何一項都會造成設定、狀態或連接埠衝突。即使 OPENCLAW_ALLOW_MULTI_GATEWAY=1 略過每個設定檔的單一執行個體限制，閘道啟動程序仍會 強制要求狀態目錄的擁有權保持唯一。

連接埠對應（衍生）

基礎連接埠 = gateway.port（或 OPENCLAW_GATEWAY_PORT／--port）。

• 瀏覽器控制服務連接埠 = 基礎連接埠 + 2（僅限回送介面）。
• Canvas 主機由閘道 HTTP 伺服器本身提供服務（與 gateway.port 使用相同連接埠）。
• 瀏覽器設定檔的 CDP 連接埠會從 browser control port + 9 到 + 108 自動配置。

若在設定或環境變數中覆寫其中任何項目，則必須確保每個執行個體使用的值皆不相同。

瀏覽器／CDP 注意事項（常見陷阱）

• 不要在多個執行個體中將 browser.cdpUrl 固定為相同的值。
• 每個執行個體都需要自己的瀏覽器控制連接埠和 CDP 範圍（由其閘道連接埠衍生）。
• 若要明確指定 CDP 連接埠，請為每個執行個體設定 browser.profiles.<name>.cdpPort。
• 若使用遠端 Chrome，請使用 browser.profiles.<name>.cdpUrl（每個設定檔、每個執行個體分別設定）。

手動環境變數範例

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

快速檢查

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 服務。
• 只有在你刻意執行多個隔離的閘道，或 OpenClaw 無法確認可連線的探查目標是否為同一個閘道時，才應出現 gateway probe 警告文字，例如 multiple reachable gateway identities detected。即使傳輸連接埠不同，通往同一閘道的 SSH 通道、Proxy URL 或已設定的遠端 URL，仍是具有多種傳輸方式的一個閘道。

相關內容

• 閘道操作手冊
• 閘道鎖定
• 設定