---
read_when:
    - 在同一台機器上執行多個閘道
    - 每個閘道都需要隔離的設定、狀態與連接埠
summary: 在單一主機上執行多個 OpenClaw 閘道（隔離、連接埠與設定檔）
title: 多個閘道
x-i18n:
    generated_at: "2026-07-14T13:40:40Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 25
    provider: openai
    source_hash: 655fa865a98064d7c017a7c2eb08ea9a9683002d96a3dbe45a8c16cbd3c86ba1
    source_path: gateway/multiple-gateways.md
    workflow: 16
---

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

## 救援機器人快速入門

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

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

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

```bash
# 救援機器人（獨立的 Telegram 機器人、獨立的設定檔、連接埠 19789）
openclaw --profile rescue onboard
openclaw --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 機器人權杖

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

## 一般多閘道設定

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

```bash
# 主要閘道（預設設定檔）
openclaw setup
openclaw gateway --port 18789

# 額外閘道
openclaw --profile ops setup
openclaw --profile ops gateway --port 19789
```

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

```bash
openclaw --profile main setup
openclaw --profile main gateway --port 18789

openclaw --profile ops setup
openclaw --profile ops gateway --port 19789
```

服務也遵循相同模式：

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

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

## 隔離檢查清單

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

| 設定                         | 用途                                 |
| ---------------------------- | ------------------------------------ |
| `OPENCLAW_CONFIG_PATH`       | 每個執行個體的設定檔案               |
| `OPENCLAW_STATE_DIR`         | 每個執行個體的工作階段、認證資訊、快取 |
| `agents.defaults.workspace`  | 每個執行個體的工作區根目錄           |
| `gateway.port`（或 `--port`） | 每個執行個體皆須唯一                 |
| 衍生的瀏覽器／CDP 連接埠    | 請參閱下文                           |

共用其中任何一項都會造成設定、狀態或連接埠衝突。即使
`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`（每個設定檔、每個執行個體分別設定）。

## 手動環境變數範例

```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 --deep
openclaw --profile rescue gateway status --deep
openclaw --profile rescue gateway probe
openclaw status
openclaw --profile rescue status
openclaw --profile rescue browser status
```

- `gateway status --deep` 可找出舊版安裝所遺留的 launchd/systemd/schtasks 服務。
- 只有在你刻意執行多個隔離的閘道，或 OpenClaw 無法確認可連線的探查目標是否為同一個閘道時，才應出現 `gateway probe` 警告文字，例如 `multiple reachable gateway identities detected`。即使傳輸連接埠不同，通往同一閘道的 SSH 通道、Proxy URL 或已設定的遠端 URL，仍是具有多種傳輸方式的一個閘道。

## 相關內容

- [閘道操作手冊](/zh-TW/gateway)
- [閘道鎖定](/zh-TW/gateway/gateway-lock)
- [設定](/zh-TW/gateway/configuration)