Skip to main content

​
多个网关（同一主机）

大多数设置应使用一个网关，因为单个网关可以处理多个消息连接和代理。如果你需要更强的隔离或冗余（例如救援机器人），请运行具有独立配置文件/端口的单独网关。

​
隔离检查清单（必需）

  • OPENCLAW_CONFIG_PATH — 每实例配置文件
  • OPENCLAW_STATE_DIR — 每实例会话、凭据、缓存
  • __ INLINE_CODE_7__ — 每实例工作区根目录
  • 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

​
救援机器人指南

在同一主机上运行第二个网关，为其配备自己的：
  • 配置文件/配置
  • 状态目录
  • 工作区
  • 基础端口（以及衍生端口）
这可使救援机器人与主机器人保持隔离，以便在主机器人宕机时进行调试或应用配置更改。 端口间隔：基础端口之间至少留出 20 个端口，以确保衍生的浏览器/画布/CDP 端口永远不会发生冲突。

​
安装方法（救援机器人）

# Main bot (existing or fresh, without --profile param)
# Runs on port 18789 + Chrome CDC/Canvas/... Ports 
openclaw onboard
openclaw gateway install

# Rescue bot (isolated profile + ports)
openclaw --profile rescue onboard
# Notes: 
# - workspace name will be postfixed with -rescue per default
# - Port should be at least 18789 + 20 Ports, 
#   better choose completely different base port, like 19789,
# - rest of the onboarding is the same as normal

# To install the service (if not happened automatically during onboarding)
openclaw --profile rescue gateway install

​
端口映射（衍生）

基础端口 = gateway.port（或 OPENCLAW_GATEWAY_PORT / --port）。
  • 浏览器控制服务端口 = 基础端口 + 2（仅限环回）
  • canvasHost.port = base + 4
  • 浏览器配置文件 CDP 端口从 browser.controlPort + 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-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