功能
Headless nodes 和设备宿主边界怎么分
基于最新官方 Nodes、Architecture 与 Pairing 文档,解释 headless nodes、普通设备节点和 Gateway 之间的职责差异,帮助团队理解“能力跑在哪台机器上”这条边界。
AI 摘要
这页重点
基于最新官方 Nodes、Architecture 与 Pairing 文档,解释 headless nodes、普通设备节点和 Gateway 之间的职责差异,帮助团队理解“能力跑在哪台机器上”这条边界。
功能
nodes / headless / pairing / devices / gateway
最后更新 2026-03-25,来源 OpenClaw Docs
Headless nodes 和设备宿主边界怎么分
现有中文资料已经解释了 nodes 是设备能力入口,但最近官方文档里还有一条更值得单独拆开的边界:
- node 不是都长得一样
从官方最近对 architecture、nodes 和 pairing 的写法看,OpenClaw 实际上已经把下面几类宿主慢慢分开了:
- Gateway host
- 带 UI 的真实设备节点
- headless nodes
先记住一句话
- Gateway 持有系统状态
- node 持有设备能力
- headless node 更像“没有人机界面的能力宿主”
这三者如果不分清,后面最容易把部署、授权和排障混成一团。
普通设备节点更像什么
更典型的普通 node 通常是:
- 手机
- 平板
- 桌面设备
它们的共同特点是:
- 有真实用户
- 有系统权限弹窗
- 有设备本地开关
- 能提供相机、语音、位置等能力
所以它们更接近:
- 被人持有、被人授权的设备边缘
headless node 更像什么
从官方 architecture 的表达看,headless nodes 更适合被理解成:
- 长期在线
- 没有明显交互 UI
- 主要提供某类能力面
它可能更像:
- 一台专门提供某种输入/执行能力的小宿主
- 一台持续在线的辅助进程节点
而不是“另一个迷你 Gateway”。
为什么 headless node 这条线值得单独看
因为它会改变你对很多问题的判断方式:
- 权限到底在哪一层授予
- 配对到底是在接谁
- 出问题时该查哪台宿主
如果你把 headless node 当普通客户端,后面会误判很多能力边界。
Gateway 和 headless node 不是主从复制关系
官方文档一直在强调:
- Gateway 是 single source of truth
这意味着即使你加了 headless node,系统事实来源仍然在 Gateway,而不是被切成多套副本。
更准确地说:
- Gateway 统一编排
- nodes 暴露能力
- headless node 只是某类能力的宿主
配对在这里为什么仍然关键
无论是不是 headless,当前官方写法都在强调:
- Node 仍然要经过显式 pairing
这不是形式步骤,而是在说明:
- “长期在线的能力宿主”也必须进入同一套授权边界
所以更不应该因为它没有明显 UI,就把它当“内部服务默认可信”。
更适合 headless node 的场景
- 持续在线的能力代理
- 需要长期运行但不依赖人工交互的节点
- 和主 Gateway 分开部署的设备能力面
更适合普通设备 node 的场景
- 相机拍照
- 位置读取
- 语音唤醒
- 明显依赖本地用户权限确认的能力
中文团队最容易踩的坑
1. 把 headless node 当成第二个 Gateway
它不是状态中心。
2. 把设备权限问题当成 node 配对问题
能配对,不等于本地权限已经开对。
3. 不记录能力到底跑在哪台宿主
后面排障时最容易迷路。
一条更稳的理解顺序
- 先确认系统状态在 Gateway
- 再确认能力实际跑在哪台 node 宿主
- 再确认这台宿主是普通设备还是 headless node
- 最后才排 pairing、权限和调用链