多个openclaw之间如何互相通信

OpenClaw 多实例通信主要分同机多 Gateway与跨机远程两类场景核心是靠端口隔离、共享 workspace 与sessions_send实现互通docs.openclaw.ai。下面按场景给出可直接落地的配置与命令。一、同主机多实例多 Gateway通信适合强隔离需求如主实例与调试实例关键是端口、配置、状态、工作区全独立docs.openclaw.ai。1. 基础隔离配置必做每个实例用不同环境变量启动避免冲突表格环境变量作用示例值OPENCLAW_CONFIG_PATH独立配置文件路径~/.openclaw/gw1/config.jsonOPENCLAW_STATE_DIR会话 / 凭证 / 缓存目录~/.openclaw/gw1/stateagents.defaults.workspace工作区根目录~/.openclaw/gw1/workspacegateway.port基础端口留 20 端口间距18780另一实例用 188002. 快速启动第二个 Gatewaybash运行# 第二个实例示例端口 18800 mkdir -p ~/.openclaw/gw2/{config,state,workspace} # 写独立配置 cat ~/.openclaw/gw2/config.json EOF { gateway: { port: 18800, remote: { enabled: false } }, agents: { defaults: { workspace: ~/.openclaw/gw2/workspace } } } EOF # 启动 env \ OPENCLAW_CONFIG_PATH~/.openclaw/gw2/config.json \ OPENCLAW_STATE_DIR~/.openclaw/gw2/state \ openclaw gateway start3. 同机互通方式共享 workspace 通信将实例 A 的 workspace 软链到实例 B或统一指向共享目录通过文件读写传递数据。sessions_send直连指定目标端口与会话 key直接跨实例通信。bash运行# 向另一实例的 agent 发消息端口 18800 openclaw --gateway-port 18800 sessions send \ --session-key agent:main:default \ --message 来自另一实例的消息二、跨主机远程实例通信适合多设备协同基于 WebSocket 远程网关。1. 远程网关配置在服务器实例开启远程访问json// ~/.openclaw/config.json { gateway: { port: 18780, remote: { enabled: true, token: openssl rand -hex 32 | tr -d \n // 生成安全 token } } }重启生效openclaw gateway restart2. 本地实例连接远程bash运行# 本地实例连接远程网关 openclaw config set gateway.remote.url wss://远程服务器IP:18780 openclaw config set gateway.remote.token 你的远程token openclaw gateway restart3. 跨机通信命令bash运行# 向远程实例的 agent 发消息 openclaw sessions send \ --session-key agent:design:default \ --message 远程设计实例请输出方案三、多 Agent 同实例内通信基础同实例内靠sessions_send/sessions_spawn实现需开启总开关并配置白名单。1. 启用总开关json// openclaw.json { tools: { agentToAgent: { enabled: true } } }2. 发送消息示例python运行# Python SDK from openclaw import OpenClaw oc OpenClaw() # 向 write agent 发消息并等待回复 resp oc.sessions_send( session_keyagent:write:default, message请根据 main 的内容续写, timeout_seconds30 ) print(resp[reply])3. 任务下发隔离执行bash运行# 生成子代理并执行任务 openclaw sessions spawn \ --parent-session agent:main:default \ --model claude-3-sonnet \ --workspace ~/.openclaw/workspaces/write \ --message 撰写技术文档四、最佳实践与避坑端口规划基础端口间留 ≥20 间距避免派生端口冲突docs.openclaw.ai。安全加固远程网关务必启用强 token禁止公开裸端口。通信选型实时对话用sessions_send。可靠任务交接共享 workspace 文件加心跳重试。跨机长连接远程 gateway WebSocket。隔离优先即使通信仍保持独立 workspace 与 sandbox避免数据污染。五、常用命令速查表格场景命令启动第二个 Gateway见 “快速启动第二个 Gateway”同机直连另一实例openclaw --gateway-port 18800 sessions send ...连接远程网关openclaw config set gateway.remote.url wss://IP:端口同实例 Agent 互发openclaw sessions send --session-key ...