节点入门
节点（Node）是连接到 Gateway 的设备。
它可以是你的手机、Mac、远程机器，也可以是一个无界面的 node host。节点不是 Gateway，它更像 Gateway 的“外接手脚”。
先分清 Gateway 和 Node
| 名词 | 人话解释 |
|---|---|
| Gateway | 总服务台，负责接消息、调度 Agent、管理连接 |
| Node | 外接设备，给 Gateway 提供相机、Canvas、语音、远程命令等能力 |
举个例子：
text
你在 Telegram 发消息
↓
Gateway 收到消息
↓
Agent 想让手机打开 Canvas 或拍照
↓
Gateway 调用已配对的手机 Node节点能做什么
具体能力取决于平台和版本，常见能力包括：
你可以把节点理解成“AI 可以请它帮忙的设备”。
节点怎么连接 Gateway
节点通过和控制 UI 类似的 WebSocket 连到 Gateway，同一个默认端口：
text
127.0.0.1:18789区别是节点连接时会声明：
json
{
"role": "node"
}并告诉 Gateway 自己有哪些能力，例如 canvas.*、camera.*、screen.record、location.get。
节点需要配对
新节点不是连上就能用。Gateway 会创建配对请求，你需要批准。
常用命令：
bash
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
openclaw nodes status这一步像给新设备开门禁。批准后，这台设备才算被信任。
远程 node host
如果 Gateway 在一台机器上，但你想让命令在另一台机器执行，可以在另一台机器上运行 node host。
例子：
bash
openclaw node run --host <gateway-host> --port 18789 --display-name "Build Node"如果 Gateway 只监听本机地址，需要先用 SSH 隧道或 Tailscale 让 node host 能安全连到它。
安全提醒
节点可以提供很强的能力，尤其是远程命令执行。所以要注意：
- 只批准你认识的设备。
- 高风险命令用 allowlist 或审批。
- 远程连接优先使用 Tailscale、VPN 或 SSH 隧道。
- 不要把 Gateway 端口直接暴露到公网。
- 节点权限变化时，重新检查配对请求。
常见问题
节点列表里看不到设备？
先确认 Gateway 在运行：
bash
openclaw gateway status再确认节点能访问 Gateway 地址和端口。如果是远程机器，优先检查 Tailscale 或 SSH 隧道。
批准节点后还是不能用？
运行：
bash
openclaw nodes status
openclaw nodes describe --node <id或名称>看它是否在线，以及它声明了哪些命令能力。
Node 会替代 Gateway 吗？
不会。节点只是外接设备。消息入口、Agent 调度、会话管理仍然在 Gateway。