📱 OpenClaw节点管理指南

🌐 什么是节点管理？

OpenClaw的节点系统允许你将多个设备配对到同一个Gateway下，Agent可以通过nodes工具与这些设备进行交互。这就像是给你的Agent配备了多个"身体"，每个身体都在不同的地方执行任务。

支持的节点操作

🛠️ 节点管理工具详解

1. 查看节点状态

nodes({
  action: "status"
})

返回结果包含节点ID、名称、在线状态、设备类型等信息。

2. 获取节点详细信息

nodes({
  action: "describe",
  node: "my-iphone"
})

3. 远程拍照

// 使用前置摄像头拍照
nodes({
  action: "camera_snap",
  node: "my-iphone",
  facing: "front"
})

// 使用后置摄像头拍照
nodes({
  action: "camera_snap",
  node: "my-iphone",
  facing: "back"
})

4. 屏幕录制

nodes({
  action: "screen_record",
  node: "my-iphone",
  durationMs: 30000,  // 录制30秒
  includeAudio: true
})

5. 获取位置

nodes({
  action: "location_get",
  node: "my-iphone",
  desiredAccuracy: "balanced"  // precise/balanced/coarse
})

6. 管理通知

// 列出通知
nodes({
  action: "notifications_list",
  node: "my-iphone",
  limit: 10
})

// 回复通知
nodes({
  action: "notifications_action",
  node: "my-iphone",
  notificationKey: "msg_123",
  notificationAction: "reply",
  notificationReplyText: "收到，稍后处理"
})

💡 实战场景

场景1：远程监控家庭设备

// 每天检查一次家庭设备
cron({
  name: "家庭设备巡检",
  schedule: { kind: "cron", expr: "0 9 * * *" },
  payload: {
    kind: "agentTurn",
    message: "检查家庭设备状态：使用nodes工具查询'home-hub'、'security-cam'节点状态，生成报告"
  }
})

场景2：远程技术支持

// 用户请求技术支持
1. 请求用户授权访问其设备节点
2. 使用 nodes({ action: "screen_record" }) 录制操作过程
3. 分析录屏内容，定位问题
4. 通过 nodes({ action: "invoke" }) 发送修复命令

场景3：多设备协同工作

// 从手机获取照片，上传到服务器处理
1. nodes({ action: "camera_snap", node: "my-iphone" })
2. 接收照片后，上传到云端
3. 在服务器节点上执行AI分析
4. 将结果推送到桌面端

📚 相关链接