Files
openclaw/docs/zh-CN/gateway/multiple-gateways.md
Josh Palmer a3ec2d0734 Docs: update zh-CN translations and pipeline
What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
2026-02-03 13:23:00 -08:00

3.8 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
在同一台机器上运行多个 Gateway 网关
你需要每个 Gateway 网关有隔离的配置/状态/端口
在同一主机上运行多个 OpenClaw Gateway 网关(隔离、端口和配置文件) 多 Gateway 网关
generated_at model provider source_hash source_path workflow
2026-02-03T07:48:13Z claude-opus-4-5 pi 09b5035d4e5fb97c8d4596f7e23dea67224dad3b6d9e2c37ecb99840f28bd77d gateway/multiple-gateways.md 15

多 Gateway 网关(同一主机)

大多数设置应该使用单个 Gateway 网关,因为一个 Gateway 网关可以处理多个消息连接和智能体。如果你需要更强的隔离或冗余(例如,救援机器人),请使用隔离的配置文件/端口运行多个 Gateway 网关。

隔离检查清单(必需)

  • OPENCLAW_CONFIG_PATH — 每个实例的配置文件
  • OPENCLAW_STATE_DIR — 每个实例的会话、凭证、缓存
  • agents.defaults.workspace — 每个实例的工作区根目录
  • gateway.port(或 --port)— 每个实例唯一
  • 派生端口(浏览器/画布)不得重叠

如果这些是共享的,你将遇到配置竞争和端口冲突。

推荐:配置文件(--profile

配置文件自动限定 OPENCLAW_STATE_DIR + OPENCLAW_CONFIG_PATH 范围并为服务名称添加后缀。

# main
openclaw --profile main setup
openclaw --profile main gateway --port 18789

# rescue
openclaw --profile rescue setup
openclaw --profile rescue gateway --port 19001

按配置文件的服务:

openclaw --profile main gateway install
openclaw --profile rescue gateway install

救援机器人指南

在同一主机上运行第二个 Gateway 网关,使用独立的:

  • 配置文件/配置
  • 状态目录
  • 工作区
  • 基础端口(加上派生端口)

这使救援机器人与主机器人隔离,以便在主机器人宕机时可以调试或应用配置更改。

端口间距:在基础端口之间至少留出 20 个端口,这样派生的浏览器/画布/CDP 端口永远不会冲突。

如何安装(救援机器人)

# 主机器人(现有或新建,不带 --profile 参数)
# 运行在端口 18789 + Chrome CDC/Canvas/... 端口
openclaw onboard
openclaw gateway install

# 救援机器人(隔离的配置文件 + 端口)
openclaw --profile rescue onboard
# 注意:
# - 工作区名称默认会添加 -rescue 后缀
# - 端口应至少为 18789 + 20 个端口,
#   最好选择完全不同的基础端口,如 19789
# - 其余的新手引导与正常相同

# 安装服务(如果在新手引导期间没有自动完成)
openclaw --profile rescue gateway install

端口映射(派生)

基础端口 = gateway.port(或 OPENCLAW_GATEWAY_PORT / --port)。

  • 浏览器控制服务端口 = 基础 + 2仅 loopback
  • canvasHost.port = 基础 + 4
  • 浏览器配置文件 CDP 端口从 browser.controlPort + 9 .. + 108 自动分配

如果你在配置或环境变量中覆盖了这些,必须确保每个实例都唯一。

浏览器/CDP 注意事项(常见陷阱)

  • 不要在多个实例上将 browser.cdpUrl 固定为相同的值。
  • 每个实例需要自己的浏览器控制端口和 CDP 范围(从其 Gateway 网关端口派生)。
  • 如果你需要显式的 CDP 端口,请为每个实例设置 browser.profiles.<name>.cdpPort
  • 远程 Chrome使用 browser.profiles.<name>.cdpUrl(每个配置文件,每个实例)。

手动环境变量示例

OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \
OPENCLAW_STATE_DIR=~/.openclaw-main \
openclaw gateway --port 18789

OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \
OPENCLAW_STATE_DIR=~/.openclaw-rescue \
openclaw gateway --port 19001

快速检查

openclaw --profile main status
openclaw --profile rescue status
openclaw --profile rescue browser status