大多数场景用单个 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

相关