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 的配对请求。

命令策略(双重门控)

  1. 节点必须在 WebSocket connect.commands 列表中声明该命令
  2. 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 start

Exec 审批存储在节点主机的 ~/.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 … 命令可直接操作本机。