跳转至

多个网关

大多数部署只需要一个网关——单个网关即可处理多个消息连接和代理。仅当您需要更强的隔离或冗余(例如,救援机器人)时,才使用独立的配置文件和端口运行多个网关。

救援机器人快速开始

最简单的救援机器人设置:

  • 让主机器人使用默认配置文件运行。
  • 在 --profile rescue 配置下运行救援机器人,并使用其自己的 Telegram 机器人令牌。
  • 将救援机器人放在不同的基础端口上,例如 19789。

这样,当主机器人发生故障时,救援机器人仍能进行调试或应用配置更改。在基础端口之间至少保留 120 个端口的间隔,以便派生的沙箱/浏览器/CDP 端口永远不会冲突。每个实例最高可达 base + 110:其浏览器控制端口为 base + 2,该端口的 CDP 范围一直延伸到 base + 110。

# 救援机器人(独立的 Telegram 机器人、独立的配置文件、端口 19789)
openclaw --profile rescue onboard
openclaw --profile rescue gateway install --port 19789

如果您的机器人已在运行,通常这样就可以了。如果 onboard 已安装救援服务,请跳过最后的 gateway install。

在 openclaw --profile rescue onboard 过程中:

  • 使用独立的 Telegram 机器人令牌,专门用于救援账户。这样很容易保持仅限操作员使用,它能独立于主机器人的频道和应用安装,并提供基于 DM 的简单恢复路径。
  • 保留 rescue 配置文件名称。
  • 使用比主机器人至少高 120 的基础端口。
  • 除非您已经自行管理,否则请接受默认的救援工作区。

--profile rescue onboard 会更改的内容

--profile rescue onboard 运行正常的引导流程,但将所有内容写入独立的配置文件,因此救援机器人会获得自己独立的:

  • 配置文件/配置文件
  • 状态目录
  • 工作区(默认:~/.openclaw/workspace-rescue)
  • 托管的服务名称
  • 基础端口(以及派生端口)
  • Telegram 机器人令牌

除此之外,提示与正常引导完全相同。

通用多网关设置

相同的隔离模式适用于单台主机上的任意网关对或网关组。为每个额外网关指定独立的命名配置文件和基础端口。

openclaw setup 在尚未配置的配置文件上运行引导。它与上面救援机器人所用的 onboard 命令的首次运行工作相同。当您希望在已配置的配置文件上运行引导流程时,请使用 onboard。

# 主(默认配置文件)
openclaw setup
openclaw gateway --port 18789

# 额外网关
openclaw --profile ops setup
openclaw --profile ops gateway --port 19789

两侧都使用命名配置文件也同样适用:

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

openclaw --profile ops setup
openclaw --profile ops gateway --port 19789

服务遵循相同模式:

openclaw gateway install
openclaw --profile ops gateway install --port 19789

使用救援机器人快速开始来实现备用操作员通道。使用通用配置文件模式来应对跨不同频道、租户、工作区或操作角色的多个长期运行的网关。

隔离检查清单

确保每个网关实例保持以下项的独特性:

设置 用途
OPENCLAW_CONFIG_PATH 每个实例的配置文件
OPENCLAW_STATE_DIR 每个实例的会话、凭据、缓存
agents.defaults.workspace 每个实例的工作区根目录
gateway.port(或 --port) 每个实例唯一
派生的沙箱/浏览器/CDP 端口 请参见下文

共享其中任何一项都会导致配置、状态或端口冲突。网关启动时会强制要求唯一的状态目录所有权,即使设置了 OPENCLAW_ALLOW_MULTI_GATEWAY=1 也是如此。

警告

仅靠 OPENCLAW_STATE_DIR 并不能隔离托管的网关服务。服务名称遵循配置文件,而不是状态目录。对于引导或服务安装测试,请使用专用的命名配置文件和唯一端口,或使用隔离的机器。请勿针对临时状态目录安装或重启默认服务。

端口映射(派生)

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

  • 当隔离的 widget/MCP 应用主机处于活动状态时,沙箱主机监听端口 = base + 1(除非 mcp.apps.sandboxPort 覆盖它)。
  • 浏览器控制服务端口 = base + 2(仅限回环)。
  • 托管的 widget 文档和 A2UI 渲染器资源由网关 HTTP 服务器本身提供服务(与 gateway.port 相同端口)。
  • 浏览器配置文件的 CDP 端口从 浏览器控制端口 + 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 \
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
openclaw status
openclaw --profile rescue status
openclaw --profile rescue browser status
  • gateway status --deep 能捕获来自旧安装的残留 launchd/systemd/schtasks 服务。
  • doctor --deep 在无法检查可识别的服务定义或本机服务管理器时也会报告。请恢复检查访问权限并重新运行 Doctor;不完整的扫描不能证明不存在其他服务。检查警告永远不能用于授权服务清理。
  • 在两种情况下,gateway probe 的警告文本(例如 检测到多个可达的网关身份)是符合预期的。您有意运行了多个隔离的网关,或者 OpenClaw 无法证明可达的检查目标是同一个网关。通过 SSH 隧道、代理 URL 或配置的远程 URL 连接到同一网关,即便传输端口不同,也属于具有多种传输方式的同一个网关。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw