多网关（同一主机）

多数场景只需一个网关，因为单个网关即可处理多条消息连接和多个 agent。若需要更强隔离或冗余（例如救援机器人），可用独立配置/端口运行多个网关。

隔离清单（必做）

CLAWDBOT_CONFIG_PATH — 每实例独立配置文件
CLAWDBOT_STATE_DIR — 每实例独立会话、凭据、缓存
agents.defaults.workspace — 每实例工作区根目录
gateway.port（或 --port）— 每实例唯一端口
派生端口（browser/canvas）不得重叠

若这些在多个实例间共享，会出现配置竞态和端口冲突。

推荐：配置档（`--profile`）

配置档会自动限定 CLAWDBOT_STATE_DIR 和 CLAWDBOT_CONFIG_PATH，并为服务名加后缀。


# 主实例
moltbot --profile main setup
moltbot --profile main gateway --port 18789

# 救援实例
moltbot --profile rescue setup
moltbot --profile rescue gateway --port 19001

每配置档的服务安装：


moltbot --profile main gateway install
moltbot --profile rescue gateway install

救援机器人指南

在同一主机上运行第二个网关，使用独立的：

配置档/配置
状态目录
工作区
基础端口（及派生端口）

这样救援机器人与主机器人隔离，主机器人不可用时仍可调试或改配置。端口间隔：基础端口之间至少留 20 个端口，避免派生 browser/canvas/CDP 端口冲突。

如何安装（救援机器人）


# 主机器人（已有或新建，不加 --profile）
# 使用端口 18789 + Chrome CDC/Canvas/... 等派生端口
moltbot onboard
moltbot gateway install

# 救援机器人（独立配置档 + 端口）
moltbot --profile rescue onboard
# 说明：
# - 工作区名称默认会加 -rescue 后缀
# - 端口建议至少 18789 + 20，更好是另选基础端口如 19789
# - 其余引导步骤与普通安装相同

# 若引导时未自动安装服务，可手动安装
moltbot --profile rescue gateway install

端口映射（派生）

基础端口 = gateway.port（或 CLAWDBOT_GATEWAY_PORT / --port）。

browser 控制服务端口 = 基础端口 + 2（仅回环）
canvasHost.port = 基础端口 + 4
Browser profile 的 CDP 端口从 browser.controlPort + 9 .. + 108 自动分配

若在配置或环境变量中覆盖其中任意一项，须保证每实例唯一。

Browser/CDP 说明（常见坑）

不要在多个实例上把 browser.cdpUrl 设成相同值。
每个实例需要自己的 browser 控制端口和 CDP 范围（由其网关端口派生）。
若需显式 CDP 端口，按实例设置 browser.profiles.<name>.cdpPort。
远程 Chrome：使用 browser.profiles.<name>.cdpUrl（每 profile、每实例）。

手动环境变量示例


CLAWDBOT_CONFIG_PATH=~/.clawdbot/main.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-main \
moltbot gateway --port 18789

CLAWDBOT_CONFIG_PATH=~/.clawdbot/rescue.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-rescue \
moltbot gateway --port 19001

快速检查


moltbot --profile main status
moltbot --profile rescue status
moltbot --profile rescue browser status