网络与发现
网络模型
绝大多数操作都经由网关(openclaw gateway)处理——这是一个常驻后台的进程,负责管理所有频道连接和 WebSocket 控制平面。
核心规则
- 一机一网关是推荐配置。网关是唯一被允许持有 WhatsApp Web 会话的进程。如果你需要运行救援机器人或实现严格的资源隔离,可以启动多个网关实例,但必须使用独立的配置文件和端口。详见多网关。
- 本地回环优先:网关的 WebSocket 默认绑定
ws://127.0.0.1:18789。配置向导会自动生成网关令牌,即使是本地回环连接也不例外。若要通过 tailnet 访问,需要运行openclaw gateway --bind tailnet --token ...,因为非本地回环绑定必须使用令牌认证。 - 节点根据实际需求,通过局域网、tailnet 或 SSH 隧道连接到网关 WebSocket。旧版的 TCP 桥接方式已弃用。
- 画布主机由网关的 HTTP 服务器提供,使用与网关相同的端口(默认
18789):/__openclaw__/canvas//__openclaw__/a2ui/当配置了gateway.auth且网关绑定到非本地回环地址时,这些路由会受到网关认证保护。节点客户端会使用与当前活跃 WebSocket 会话绑定的节点级能力 URL。详见网关配置(canvasHost、gateway字段)。
- 远程使用通常通过 SSH 隧道或 tailnet VPN 实现。详见远程访问和服务发现。