很多人第一次接触 OpenClaw 时,最容易把 gateway 理解成“主程序”,把 node 理解成“另一个网关”。
但从架构上看,OpenClaw 的设计其实更像两层系统:
- •
gateway是控制面,负责接入消息渠道、维护会话、运行模型、路由工具调用。 - •
node是执行面和设备面,负责把某台机器的能力接进来,让 OpenClaw 真正去操作那台设备。
如果只把 OpenClaw 当成一个聊天机器人,gateway 已经够用了;但如果你希望它控制更多机器、调用更多设备能力、把命令执行放到指定主机上,node 才是关键。
这篇文章不先讲配对,而是先把 node 的架构机制、用途和适用场景讲清楚。最后再用一个最实用的例子收尾:WSL2 上运行 gateway,Windows 上运行 node,把 OpenClaw 的控制面和执行面拆开。
一、OpenClaw Node 到底是什么
node 不是第二个 gateway,也不是一个“更轻量的聊天入口”。
它更准确的定位是:挂在 Gateway 后面的设备能力提供者和远程执行宿主。
从官方定义看,node 会以 role: "node" 的身份连接到 Gateway 的 WebSocket,向 Gateway 广告自己能提供哪些能力。对于 OpenClaw 来说,这些能力可能包括:
- •
system.run、system.which这样的命令执行能力 - •
camera.*、canvas.*、notifications.*这样的设备能力 - • 某些平台上的浏览器代理或系统级扩展能力
换句话说,Gateway 并不需要自己拥有所有权限和所有外设。它只需要知道“哪一个 node 能做什么”,然后在合适的时候把调用路由过去。
这个设计和很多传统 Agent 工具的区别非常明显:
- • 传统做法通常是“模型和执行都在同一台机器上”
- • OpenClaw 的做法是“模型和编排在 Gateway,执行和设备访问在 Node”
一旦你理解了这一点,后面很多配置问题都会变简单。因为你会知道:node 的意义从来不是多开一个服务,而是把 OpenClaw 的能力延伸到别的设备上。
二、Node 在架构上解决了什么问题
1. 把控制面和执行面拆开
在没有 node 的情况下,OpenClaw 的命令执行天然落在 Gateway 所在主机。
这意味着:
- • Gateway 在哪里,命令就在哪里执行
- • Gateway 有什么权限,模型就能间接调什么权限
- • 设备能力和系统权限都跟 Gateway 主机强绑定
Node 把这件事解耦了。
Gateway 继续负责:
- • 接收用户消息
- • 调用模型
- • 维护会话状态
- • 决定要不要使用工具
Node 则负责:
- • 在具体机器上执行命令
- • 暴露设备能力
- • 以该机器本地的权限边界处理审批和 allowlist
所以在逻辑上,Gateway 更像“大脑和中控台”,Node 更像“手脚和外设接口”。
2. 让 OpenClaw 具备多设备能力
如果只有 Gateway,OpenClaw 只能控制 Gateway 所在的那一台机器。
有了 Node 以后,它就可以扩展成一套多设备系统。例如:
- • Gateway 跑在一台常驻在线的 Linux 主机上
- • 你的 Windows 工作站作为一个 node 接入
- • 你的 macOS 电脑作为另一个 node 接入
- • 某台专门跑构建任务的机器再作为一个 headless node 接入
这样一来,OpenClaw 看到的就不再是一台机器,而是一组可调度的能力节点。
3. 把安全边界放回设备本地
这一点非常重要,但也最容易被忽略。
OpenClaw 的 exec approvals 和 allowlist 不是抽象地保存在“系统中心”,而是跟随实际执行主机生效。
这意味着:
- • 命令在 Gateway 主机执行,就由 Gateway 主机本地审批
- • 命令在 Node 主机执行,就由 Node 主机本地审批
这带来的好处是,你可以把真正敏感的命令权限控制在设备本地,而不是让 Gateway 统一拥有所有机器的高权限访问。
4. 让 Gateway 常驻在线,而设备按需接入
很多人的真实使用环境不是“一台永不休眠的工作站”,而是:
- • 笔记本会睡眠
- • 本地桌面机会重启
- • 某些设备只在白天在线
如果你把 Gateway 直接跑在这些设备上,会出现一个问题:设备一睡眠,整个控制面就一起消失。
Node 的价值就是让你把 Gateway 放到一个更稳定的地方,而把设备接入变成“能力接入”而不是“系统本体”。这样即使某个 node 暂时不在线,Gateway 和会话仍然活着。
三、Node 适合什么场景
如果你只是在单台机器上偶尔跑几条命令,未必一定需要 node。
但下面这些场景,node 的价值会非常明显。
场景一:你想让 OpenClaw 常驻在线
比如你希望:
- • 消息渠道一直在线
- • Dashboard 可以持续保留会话状态
- • 模型调度不中断
这时最合理的做法,是把 Gateway 放在一个稳定宿主上,再把你自己的工作设备挂成 node。
场景二:你希望命令只在指定机器上执行
例如:
- • Git、PowerShell、浏览器自动化必须在 Windows 上执行
- • 某些图形能力或通知能力必须依赖本机桌面环境
- • 某些命令只能访问本机装好的工具链
这时 node 可以让你明确告诉 OpenClaw:控制还在 Gateway,但执行必须落在这个设备上。
场景三:你想把权限边界收紧
如果 Gateway 跑在一个更通用的 Linux 环境里,而你的个人电脑包含更多敏感文件,那么让 Gateway 直接获得本机执行权限未必是你想要的。
把个人电脑作为 node 接入,会更符合“中心编排、边缘执行”的思路。
场景四:你想扩展 OpenClaw 的设备能力
Node 的意义不只是 shell。
它的长期价值在于:OpenClaw 可以通过 node 接入不同设备的相机、画布、通知、…