加入我们的 Telegram 社群 (clawdbotCN) 学习分享和了解更多 →
节点
概览

节点

节点是 Clawdbot 的扩展设备,可以提供额外的能力如相机、麦克风、位置等。

节点类型

iOS 节点

iPhone/iPad 应用,提供:

  • 相机访问
  • 麦克风访问
  • 位置服务
  • 推送通知
  • Siri 快捷方式集成

Android 节点

Android 应用,提供:

  • 相机访问
  • 麦克风访问
  • 位置服务
  • 通知
  • Tasker 集成

macOS 节点

桌面应用,提供:

  • 屏幕截图
  • 系统信息
  • 文件系统访问
  • AppleScript 执行

节点功能

媒体理解

节点可以发送图像、音频让代理分析:

节点 → 图像 → 网关 → 代理 → 分析结果

支持:

  • 图像识别
  • 文档 OCR
  • 音频转录
  • 视频分析

相机

# 拍照
clawdbot nodes camera capture --node ios-phone
 
# 实时视频流
clawdbot nodes camera stream --node ios-phone

音频

# 录音
clawdbot nodes audio record --node ios-phone --duration 10s
 
# 语音唤醒
clawdbot nodes voicewake --node ios-phone --keyword "hey clawd"

位置

# 获取当前位置
clawdbot nodes location --node ios-phone

节点配对

节点首次连接需要配对:

# 查看待配对节点
clawdbot devices list
 
# 批准配对
clawdbot devices approve <requestId>
 
# 拒绝配对
clawdbot devices reject <requestId>

配对状态存储在:

  • ~/.clawdbot/devices/pending.json
  • ~/.clawdbot/devices/paired.json

节点配置

{
  nodes: {
    enabled: true,
    autoApprove: false,  // 不建议
    allowedCapabilities: [
      "camera",
      "microphone",
      "location"
    ]
  }
}

执行权限

控制节点可以执行的操作:

{
  nodes: {
    security: {
      systemRun: "ask",  // deny, ask, allow
      fileAccess: "allowlist"
    }
  }
}

工具调用

代理可以通过 nodes 工具与节点交互:

// 在代理提示中
请使用 iOS 节点拍一张照片给我看看
 
// 代理会调用
nodes.camera({ node: "ios-phone", action: "capture" })

安装应用

iOS

  1. 从 App Store 下载 "Clawdbot Node"
  2. 打开应用,扫描网关二维码或输入网关地址
  3. 批准设备配对

Android

  1. 从 Google Play 下载 "Clawdbot Node"
  2. 打开应用,配置网关连接
  3. 批准设备配对

故障排除

节点无法连接

  1. 检查网络连接
  2. 确保网关正在运行
  3. 验证网关地址是否正确
  4. 检查防火墙设置

能力不可用

  1. 检查应用权限(相机、麦克风等)
  2. 确认节点配置允许该能力
  3. 检查节点是否在线

相关文档