大多数场景用单个 Gateway 即可(支持多消息连接和多 agent)。需要更强隔离或冗余时(如救援 bot),才运行多个独立 Gateway。
推荐:救援 Bot 快速配置
# 救援 bot(独立 Telegram bot、独立 profile、端口 19789)
openclaw --profile rescue onboard
openclaw --profile rescue gateway install --port 19789- 使用独立 Telegram bot token
- 基础端口至少比主 bot 高 20(避免派生端口冲突)
通用多 Gateway 配置
# 主 Gateway(默认 profile)
openclaw setup
openclaw gateway --port 18789
# 额外 Gateway
openclaw --profile ops setup
openclaw --profile ops gateway --port 19789隔离清单
每个 Gateway 实例必须保持唯一:
| 配置项 | 说明 |
|---|---|
OPENCLAW_CONFIG_PATH | 独立配置文件 |
OPENCLAW_STATE_DIR | 独立状态目录(sessions、凭证、缓存) |
agents.defaults.workspace | 独立工作区根目录 |
gateway.port | 唯一端口 |
| 派生的 browser/canvas/CDP 端口 | 自动从 base port 派生 |
共享以上任何配置会导致配置竞争和端口冲突。
端口派生规则
- browser 控制服务端口 = base + 2(仅 loopback)
- canvas host 与 Gateway HTTP 同端口
- Browser CDP 端口从
browser.controlPort + 9到+ 108自动分配
手动环境变量示例
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 --deep
openclaw --profile rescue gateway status --deep
openclaw --profile rescue gateway probe