OpenClaw Nodes 设备管理深度解析：AI Agent的跨设备协作能力

目录

• • 1. 引言 - 为什么需要跨设备能力？
  • • 1.1 云端 Agent 的局限
    • 1.2 Nodes 的解决思路
    • 1.3 Nodes 能力概览
  • 2. Nodes 概念模型
  • • 2.1 核心概念
    • 2.2 通信模型
  • 3. 设备配对流程
  • • 3.1 配对方式
    • 3.2 QR 码配对实战
    • 3.3 配对状态流转
    • 3.4 配对安全机制
  • 4. 节点管理操作
  • • 4.1 查看节点列表
    • 4.2 节点状态监控
    • 4.3 解除配对
  • 5. 跨设备操作实战
  • • 5.1 在节点上执行命令
    • 5.2 通过节点控制浏览器
    • 5.3 跨设备文件操作
  • 6. 实战案例
  • • 6.1 案例1：手机节点配对与操作
    • 6.2 案例2：远程控制 Mac 桌面
    • 6.3 案例3：多节点协同工作流
  • 7. 安全与最佳实践
  • • 7.1 安全注意事项
    • 7.2 最佳实践
    • 7.3 节点配置示例
  • 8. 总结
  • • 8.1 Nodes 核心价值
    • 8.2 思考题
    • 8.3 参考链接

---

先说一个关键判断：AI Agent 的未来，绝不仅仅停留在云端。想让智能助手真正落地、帮我们干点“实事”，就必须把它从服务器里“拽”出来，让它能直接触碰我们的电脑、手机和日常设备。而这，正是 OpenClaw Nodes 要解决的核心命题。

1. 引言 - 为什么需要跨设备能力？

1.1 云端 Agent 的局限

传统 AI Agent 全部跑在云端，这听起来很酷，但实际上，它的手脚被捆得死死的。你可以把它想象成一个“盲人”——能思考，但看不见、摸不着身边的世界。

局限	说明	影响
无法访问本地文件	云端无法读取用户电脑/手机上的文件	无法处理本地文档、照片
无法控制本地应用	无法操作桌面软件、手机App	无法自动化日常操作
无法使用本地算力	无法利用设备的GPU/CPU	无法运行本地模型
无法感知本地环境	无法获取位置、传感器数据	无法提供情境化服务

1.2 Nodes 的解决思路

解决方案其实很直接：Agent 不再直接“空降”到设备上，而是通过一个叫

的中枢，把指令路由到指定的 。Node 在本地实打实地执行操作，再把结果回传给 Agent。整个过程对 Agent 来说是透明的，它只需要指明目标设备和指令内容就行了。

3. 设备配对流程

3.1 配对方式

OpenClaw 提供了两种主流的配对方式，覆盖了常见的使用场景：

方式	适用场景	操作步骤
QR 码扫描	手机端配对	1. Gateway 生成 QR 码 2. 手机 App 扫码 3. 确认配对
设置码输入	桌面端配对	1. Gateway 显示设置码 2. 桌面客户端输入 3. 确认配对

3.2 QR 码配对实战

从操作角度来看，流程非常简洁。你可以通过 CLI 命令或者 Gateway API 来触发配对请求，生成包含连接信息的 QR 码。用户在手机 App 上扫码后，App 与 Gateway 会建立 WebSocket 连接，经过验证后，节点就成功上线了。

# 在 OpenClaw 中生成节点配对 QR 码
# 方式1：通过 CLI 命令
# openclaw node pair --platform android
# 方式2：通过 Gateway API
# GET /api/nodes/pair-qr
# 配对流程：
# 1. Gateway 生成包含连接信息的 QR 码
# 2. 用户在手机 App 中扫描 QR 码
# 3. App 与 Gateway 建立 WebSocket 连接
# 4. Gateway 验证配对请求
# 5. 配对成功，节点上线

3.3 配对状态流转