yunxiafei
89a243be70
Some checks failed
CI / docs-scope (push) Has been cancelled
CI / secrets (push) Has been cancelled
CI / ios (push) Has been cancelled
Docker Release / validate_manual_backfill (push) Has been cancelled
Install Smoke / docs-scope (push) Has been cancelled
Sandbox Common Smoke / sandbox-common-smoke (push) Has been cancelled
Workflow Sanity / no-tabs (push) Has been cancelled
Workflow Sanity / actionlint (push) Has been cancelled
Workflow Sanity / config-docs-drift (push) Has been cancelled
CI / changed-scope (push) Has been cancelled
CI / build-artifacts (push) Has been cancelled
CI / release-check (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && bunx vitest run --config vitest.unit.config.ts, bun, test) (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && pnpm test, node, 2, 1, test) (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && pnpm test, node, 2, 2, test) (push) Has been cancelled
CI / checks (pnpm protocol:check, node, protocol) (push) Has been cancelled
CI / checks (pnpm test:channels, node, channels) (push) Has been cancelled
CI / checks (pnpm test:extensions, node, extensions) (push) Has been cancelled
CI / check (push) Has been cancelled
CI / startup-memory (push) Has been cancelled
CI / check-docs (push) Has been cancelled
CI / compat-node22 (push) Has been cancelled
CI / skills-python (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 1, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 2, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 3, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 4, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 5, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 6, test) (push) Has been cancelled
CI / macos (push) Has been cancelled
CI / android (./gradlew --no-daemon :app:assembleDebug, build) (push) Has been cancelled
CI / android (./gradlew --no-daemon :app:testDebugUnitTest, test) (push) Has been cancelled
Docker Release / approve_manual_backfill (push) Has been cancelled
Docker Release / build-amd64 (push) Has been cancelled
Docker Release / build-arm64 (push) Has been cancelled
Docker Release / create-manifest (push) Has been cancelled
Install Smoke / install-smoke (push) Has been cancelled
3.9 KiB
3.9 KiB
read_when, summary, title, x-i18n
| read_when | summary | title | x-i18n | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
在一台主机上运行多个 OpenClaw Gateway 网关（隔离、端口和配置档案） | 多个 Gateway 网关 |
|
多个 Gateway 网关（同一主机）
大多数设置应使用一个 Gateway 网关，因为单个 Gateway 网关可以处理多个消息连接和智能体。如果你需要更强的隔离或冗余（例如救援机器人），请运行使用隔离配置档案/端口的独立 Gateway 网关。
隔离检查清单（必需）
OPENCLAW_CONFIG_PATH— 每个实例单独的配置文件OPENCLAW_STATE_DIR— 每个实例单独的会话、凭证、缓存agents.defaults.workspace— 每个实例单独的工作区根目录gateway.port（或--port）— 每个实例唯一- 派生端口（browser/canvas）不得重叠
如果这些被共享，你会遇到配置竞争和端口冲突。
推荐：配置档案（--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 个端口，以确保派生的 browser/canvas/CDP 端口永不冲突。
如何安装（救援机器人）
# Main bot（现有或全新，不带 --profile 参数）
# 运行在端口 18789 + Chrome CDC/Canvas/... 端口
openclaw onboard
openclaw gateway install
# Rescue bot（隔离的配置档案 + 端口）
openclaw --profile rescue onboard
# 说明：
# - 工作区名称默认会追加 -rescue 后缀
# - 端口至少应为 18789 + 20 个端口，
# 最好选择完全不同的基础端口，例如 19789，
# - 其余新手引导与正常情况相同
# 安装服务（如果设置期间未自动完成）
openclaw --profile rescue gateway install
端口映射（派生）
基础端口 = gateway.port（或 OPENCLAW_GATEWAY_PORT / --port）。
- browser 控制服务端口 = 基础端口 + 2（仅 loopback）
- canvas host 由 Gateway 网关 HTTP 服务器提供（与
gateway.port使用相同端口） - Browser profile CDP 端口会从
browser.controlPort + 9 .. + 108自动分配
如果你在配置或环境变量中覆盖了其中任何一个，必须确保它们在每个实例之间保持唯一。
Browser/CDP 说明（常见陷阱）
- 不要在多个实例上将
browser.cdpUrl固定为相同值。 - 每个实例都需要自己的 browser 控制端口和 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