大多数设置应该使用单个 Gateway 网关，因为一个 Gateway 网关可以处理多个消息连接和智能体。如果你需要更强的隔离或冗余（例如，救援机器人），请使用隔离的配置文件/端口运行多个 Gateway 网关。
隔离检查清单（必需）
OPENCLAW_CONFIG_PATH — 每个实例的配置文件OPENCLAW_STATE_DIR — 每个实例的会话、凭证、缓存agents.defaults.workspace — 每个实例的工作区根目录gateway.port（或 --port）— 每个实例唯一- 派生端口（浏览器/画布）不得重叠
如果这些是共享的，你将遇到配置竞争和端口冲突。
推荐：配置文件（--profile）
配置文件自动限定 OPENCLAW_STATE_DIR + OPENCLAW_CONFIG_PATH 范围并为服务名称添加后缀。
按配置文件的服务：
救援机器人指南
在同一主机上运行第二个 Gateway 网关，使用独立的：
- 配置文件/配置
- 状态目录
- 工作区
- 基础端口（加上派生端口）
这使救援机器人与主机器人隔离，以便在主机器人宕机时可以调试或应用配置更改。
端口间距：在基础端口之间至少留出 20 个端口，这样派生的浏览器/画布/CDP 端口永远不会冲突。
如何安装（救援机器人）
端口映射（派生）
基础端口 = 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（每个配置文件，每个实例）。
手动环境变量示例
快速检查
Last modified on February 12, 2026
