OpenClaw Nodes: 伴侣设备详解

OpenClaw 中的 "nodes" 是指连接到 OpenClaw Gateway 的伴侣设备（companion devices），它们扩展了 AI 代理的能力，让代理可以访问不同设备上的硬件或功能。

什么是 Node？

Node 是一个以 role: "node" 身份通过 WebSocket 连接到 Gateway 的设备（和 operators 使用相同端口）。
它暴露一系列命令接口（command surface），比如 canvas.*、camera.*、device.*、notifications.*、system.* 等。
Gateway 通过 node.invoke 方法调用这些命令。
重要
：Node 是外围设备（peripherals），不运行 Gateway 服务本身。消息（如 Telegram/WhatsApp）还是落在 Gateway 上，而不是 Node。

官方文档核心定义（来自 https://docs.openclaw.ai/nodes）：

A node is a companion device (macOS/iOS/Android/headless) that connects to the Gateway WebSocket ... and exposes a command surface ... via node.invoke.

支持的 Node 类型

类型	平台	主要功能 / 暴露能力	典型用途
macOS app (node mode)	macOS	canvas, camera, system.run/notify	本机 macOS 扩展（菜单栏 app 可直接当 node）
iOS node	iOS	Canvas, camera, screen recording, Voice Wake, Talk Mode, Bonjour 配对	手机拍照、定位、通知、屏幕共享
Android node	Android	Canvas, camera/screen recording, notifications, location, SMS, contacts, calendar, motion 等	安卓设备控制最全面
Headless node	Linux/Windows/服务器等	主要暴露 system.run / system.which（执行 shell 命令）	远程执行命令、CI 构建机、NAS 等

常用 CLI 命令（openclaw nodes）

Bash

# 列出所有节点（包括待审批和已配对的）openclaw nodes list# 只看当前在线的openclaw nodes list --connected# 最近 24 小时连接过的openclaw nodes list --last-connected 24h# 查看待配对请求openclaw nodes pending# 批准一个节点openclaw nodes approve <requestId># 查看某个节点详细信息openclaw nodes describe "<Node Name>"# 调用节点能力（示例：让某个安卓节点拍张照）openclaw nodes invoke "<Android Node>" camera.snap

典型使用场景

让 AI 代理“用我手机拍一张现在的照片” → 调用 Android/iOS 的 camera.*
“在我 Mac 上打开某个窗口并截图” → canvas 或 system.*
“在我的 Linux 服务器上跑一段脚本” → headless node 的 system.run
“把通知发到我手机上” → notifications.*
跨设备硬件控制（remote screenshot, GPS, camera access 等）

快速入门流程（以手机为例）

在手机上安装 OpenClaw iOS/Android app。
App 通过 Bonjour / 手动输入连接到你本地的 Gateway。
Gateway 上运行 openclaw nodes pending 看到请求。
openclaw nodes approve <id> 完成配对。
之后 openclaw nodes list 就能看到它在线，代理就可以调用它的能力了。

更多细节可以参考官方文档：

https://docs.openclaw.ai/nodes （节点总览）
https://docs.openclaw.ai/cli/nodes （CLI 命令）
https://docs.openclaw.ai/platforms/ios （iOS node）
https://docs.openclaw.ai/platforms/android （Android node）

简单来说，nodes 就是 OpenClaw 让你的 AI 代理“伸出手脚”到手机、平板、服务器等设备的关键机制，是实现“跨设备个人超级助理”的核心部分。🦞