Node 是连接到 Gateway WebSocket 的伴侣设备(macOS/iOS/Android/无头),以 role: "node" 接入,通过 node.invoke 暴露命令面(canvas.*、camera.*、device.*、notifications.*、system.* 等)。
节点是外设,不是 Gateway。Telegram/WhatsApp 等消息落在 Gateway,不在节点上。
配对与状态
openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>WS 节点使用设备配对:节点在 connect 时提供设备身份,Gateway 创建 role: node 的配对请求。
命令策略(双重门控)
- 节点必须在 WebSocket
connect.commands列表中声明该命令 - Gateway 平台策略必须允许该命令
危险命令(camera.snap、camera.clip、screen.record)需通过 gateway.nodes.allowCommands 显式开启。
远程节点主机(system.run)
# 前台启动
openclaw node run --host <gateway-host> --port 18789 --display-name "Build Node"
# 服务安装
openclaw node install --host <gateway-host> --port 18789
openclaw node startExec 审批存储在节点主机的 ~/.openclaw/exec-approvals.json。
主要功能页面
| 功能 | 页面 |
|---|---|
| 摄像头捕获 | nodes-camera |
| 音频/语音笔记 | nodes-audio |
| 图像与媒体 | nodes-images |
| 媒体理解 | nodes-media-understanding |
| 位置命令 | nodes-location-command |
| Talk 模式 | nodes-talk |
| 语音唤醒 | nodes-voicewake |
| 故障排查 | nodes-troubleshooting |
权限映射
节点可在 node.list / node.describe 中包含 permissions 映射,键为权限名(如 screenRecording、accessibility),值为布尔。
macOS 节点模式
macOS 菜单栏应用以节点模式连接 Gateway WS,openclaw nodes … 命令可直接操作本机。