节点
节点（node）是一种配套设备（macOS/iOS/watchOS/Android/无头设备），它以 role: "node" 连接到 Gateway，并通过 node.invoke 暴露命令面（例如 camera.*、device.*、notifications.*、system.*）。大多数节点使用 operator 端口上的 Gateway WebSocket。可选的直接 Apple Watch 节点在同一端口上使用签名 HTTPS 轮询，因为 watchOS 会阻止普通应用使用通用的底层网络。协议详情：Gateway 协议。
macOS 也可以运行在节点模式：菜单栏应用作为一个节点连接到 Gateway 的 WS 服务器（因此 openclaw nodes … 可针对这台 Mac 操作）。该应用将原生 widget-panel、camera、screen、notification 和 computer-control 命令添加到 openclaw node run 所使用的同一节点主机命令面。不要在该 Mac 上启动第二个 CLI 节点；该应用会将匹配的 CLI 节点主机运行时作为内部 worker 运行，并保持为唯一的 Gateway 连接和节点身份。该应用的 Instances 界面以友好的硬件名称显示每台设备；有关 Apple 型号标识符如何内置（vendored）和映射，请参阅设备型号数据库。
节点是外围设备，而不是网关：它们不运行网关服务，渠道消息（Telegram、WhatsApp 等）会落在 Gateway 上，而不是节点上。
故障排查操作手册：/nodes/troubleshooting
节点页面¶
设置节点：
为节点分配任务：
- 在节点上运行命令 - 将命令加入允许列表、将 exec 指向节点、调用原始 RPC，并绑定目标。
- 节点托管的 MCP 服务器与技能 - 从节点机器发布 MCP 工具、技能和本地模型推理。
- 在节点上托管 OpenClaw 会话 - worker 会话托管、设备放置、容量和容器隔离。
- 节点会话目录 - 在 Gateway 和已配对节点上发现的 Codex、Claude、OpenCode 和 Pi 会话。
- 节点文件传输 - 终端上传，以及 File Transfer 插件的目录列表、获取和写入工具。
治理并调用设备能力：
- 节点命令策略 - 平台默认允许列表、危险命令选择加入机制，以及
gateway.nodes配置。 - 节点设备命令 - Widget panel、camera、screen recording、location、SMS 和设备数据辅助工具。
节点能力详解：
- 活动计算机在线状态 - Gateway 将哪台 Mac 视为活动，以及节点警报会落在哪里。
- 相机捕获 - 各平台的照片和片段限制，以及捕获流水线。
- 计算机使用 - 在已配对节点上进行桌面控制，以及围绕它的门控机制。
- 定位命令 -
location.get的完整参数和响应结构。 - 语音对话模式 - 在节点上进行实时语音对话。
- 语音唤醒 - 在节点上捕获唤醒词。
- 媒体理解 - 代理如何读取节点捕获的媒体。
- 媒体播放 - 通过节点播放音频和视频。
- 图像与媒体支持 - 图像格式与附件处理。
- 音频与语音备忘录 - 音频捕获与语音备忘录处理。
- 节点故障排查 - 配对、前台、权限和工具故障。
openclaw nodes- 用于列出、检查和管理节点的 CLI 参考。
各章节迁移位置¶
此页面过去发布的所有锚点仍然会解析到这里。下面每一项都带有原始锚点，并链接到其新位置。
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw