乐于分享
好东西不私藏

OpenClaw Nodes: 伴侣设备详解

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 等)

快速入门流程(以手机为例)

  1. 在手机上安装 OpenClaw iOS/Android app。
  2. App 通过 Bonjour / 手动输入连接到你本地的 Gateway。
  3. Gateway 上运行 openclaw nodes pending 看到请求。
  4. openclaw nodes approve <id> 完成配对。
  5. 之后 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 代理“伸出手脚”到手机、平板、服务器等设备的关键机制,是实现“跨设备个人超级助理”的核心部分。🦞

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料