必须启用ACP协议并配置gRPC跨节点通信,否则子Agent无法协同;需签发TLS证书、注册远程Agent、配置路由规则、启动远程服务并验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在单台电脑上突破OpenClaw单智能体的算力、内存与上下文长度限制,让多个Agent跨设备协同处理长周期任务、分布式数据采集或高并发响应,必须启用ACP协议并配置跨节点通信通道。这一步不可跳过,否则所有子Agent仍将挤在本地进程里争抢资源。
确认ACP协议已激活并支持跨节点
打开终端,执行以下命令验证当前ACP状态:
openclaw configget acp.enabled
若返回false或报错“key not found”,说明ACP未启用。立即执行:
openclaw configset acp.enabled true && openclaw configset acp.transport "grpc"
【必须使用gRPC传输层】 HTTP模式仅支持同机IPC,无法穿透防火墙或跨局域网;gRPC自带双向流与心跳保活,是跨设备协同的唯一可行通道。
重启服务使配置生效:openclaw restart
为远程节点生成可信凭证
方法一:主节点签发证书
在主控机(如你的MacBook)执行:
openclaw acp cert issue --host 192.168.3.105 --days 365 --output ~/.openclaw/certs/node-b.pem
其中192.168.3.105是待接入的Windows工作站IP,需确保该IP在目标机器上绑定到实际网卡(非127.0.0.1)。
方法二:离线生成密钥对(适用于无网络权限环境)
在目标Windows机器上运行:
openclaw acp keygen --output C:\openclaw\certs\self.key
将生成的self.key文件拷贝至主节点,再由主节点签名:
openclaw acp cert sign --key C:\openclaw\certs\self.key --host 192.168.3.105 --output C:\openclaw\certs\node-b-signed.crt
这一步完成后,目标机器必须持有self.key和node-b-signed.crt两个文件,缺一则无法建立TLS连接。
配置跨节点Agent路由规则
第一步:在主节点创建远程Agent注册条目
执行命令注册一台ID为data-collector-win的远程采集Agent:
openclaw agents add data-collector-win --remote --addr grpc://192.168.3.105:50051 --cert ~/.openclaw/certs/node-b.pem
第二步:声明该Agent可处理的数据类任务
编辑主节点的bindings配置,追加以下JSON片段(注意不要覆盖原有规则):
openclaw configset --json bindings '[{"agentId":"data-collector-win","match":{"intent":"scrape","source":"public-web"}},{"agentId":"main","match":{"intent":"summarize"}}]'
第三步:强制刷新路由缓存
openclaw acp route flush && openclaw acp route sync
此时,当主Agent收到含intent=scrape的请求,会自动转发至192.168.3.105上的data-collector-win实例,不再占用本机显存与CPU。
启动远程Agent服务并验证连通性
在Windows工作站上,以管理员身份打开PowerShell,进入OpenClaw安装目录:
cd C:\Program Files\OpenClaw
执行远程服务启动命令(指定证书路径与监听端口):
.\openclaw serve --addr :50051 --cert C:\openclaw\certs\node-b-signed.crt --key C:\openclaw\certs\self.key --mode remote
观察终端输出是否出现gRPC server started on :50051及ACP node registered as data-collector-win两行日志。
回到主节点,运行连通性测试:
openclaw acp ping data-collector-win
若返回PONG (rtt: 12ms),说明跨节点链路已就绪;若超时,请检查Windows防火墙是否放行TCP 50051端口。


















