多个openclaw之间如何互相通信

OpenClaw 多实例通信主要分同机多 Gateway与跨机远程两类场景，核心是靠端口隔离、共享 workspace 与sessions_send实现互通docs.openclaw.ai。下面按场景给出可直接落地的配置与命令。

一、同主机多实例（多 Gateway）通信

适合强隔离需求（如主实例与调试实例），关键是端口、配置、状态、工作区全独立docs.openclaw.ai。

1. 基础隔离配置（必做）

每个实例用不同环境变量启动，避免冲突：

表格

2. 快速启动第二个 Gateway

bash

运行

# 第二个实例（示例端口 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 start

3. 同机互通方式

• 共享 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 restart

2. 本地实例连接远程

bash

运行

# 本地实例连接远程网关 openclaw config set gateway.remote.url wss://远程服务器IP:18780 openclaw config set gateway.remote.token 你的远程token openclaw gateway restart

3. 跨机通信命令

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_key="agent:write:default", message="请根据 main 的内容续写", timeout_seconds=30 ) print(resp["reply"])

3. 任务下发（隔离执行）

bash

运行

# 生成子代理并执行任务 openclaw sessions spawn \ --parent-session "agent:main:default" \ --model "claude-3-sonnet" \ --workspace "~/.openclaw/workspaces/write" \ --message "撰写技术文档"

四、最佳实践与避坑

1. 端口规划：基础端口间留 ≥20 间距，避免派生端口冲突docs.openclaw.ai。
2. 安全加固：远程网关务必启用强 token，禁止公开裸端口。
3. 通信选型：
   • 实时对话：用sessions_send。
   • 可靠任务交接：共享 workspace + 文件，加心跳重试。
   • 跨机长连接：远程 gateway + WebSocket。
4. 隔离优先：即使通信，仍保持独立 workspace 与 sandbox，避免数据污染。

五、常用命令速查

表格