目录

• • 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 全部跑在云端，这听起来很酷，但实际上，它的手脚被捆得死死的。你可以把它想象成一个“盲人”——能思考，但看不见、摸不着身边的世界。这种云端部署方式严重限制了智能助手的实际应用范围。

1.2 Nodes 的解决思路

解决方案其实很直接：Agent 不再直接“空降”到设备上，而是通过一个叫 Gateway 的中枢，把指令路由到指定的 Node。Node 在本地实打实地执行操作，再把结果回传给 Agent。整个过程对 Agent 来说是透明的，它只需要指明目标设备和指令内容就行了。这种架构让智能助手首次具备了跨越设备边界的能力。

3. 设备配对流程

3.1 配对方式

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

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 配对状态流转