Clawdbot AI 助手节点用于分布式设备控制。了解如何设置和管理音频、图像和远程命令的节点。

Clawdbot 节点概述

Clawdbot 节点将您的 AI 助手扩展到物理设备和远程机器。节点支持网络中的音频播放、图像显示和命令执行。

什么是节点？

节点是运行在设备上的轻量级代理：

音频节点：播放 TTS 和音频文件
图像节点：在屏幕上显示图像
命令节点：执行远程命令

快速开始

安装节点代理

# 在目标设备上安装
npm install -g @clawdbot/node-agent

# 启动节点代理
clawdbot-node start --name "living-room"

注册节点

# 在主 Clawdbot 实例上
clawdbot nodes add living-room --host 192.168.1.100 --port 3012

节点类型

音频节点

通过设备扬声器播放音频：

功能	描述
TTS	文字转语音播放
音频文件	支持 MP3、WAV、OGG
音量控制	远程音量调节
队列	音频队列管理

了解更多关于音频节点

图像节点

在连接的屏幕上显示图像：

功能	描述
显示	在屏幕上显示图像
幻灯片	自动轮播
叠加层	文字和图形叠加

了解更多关于图像节点

配置

节点代理配置

{
  "node": {
    "name": "office-display",
    "type": ["audio", "image"],
    "port": 3012,
    "gateway": "ws://192.168.1.1:3010"
  }
}

网关节点配置

{
  "nodes": {
    "enabled": true,
    "devices": [
      {
        "name": "living-room",
        "host": "192.168.1.100",
        "port": 3012,
        "capabilities": ["audio", "image"]
      }
    ]
  }
}

节点命令

CLI

# 列出已注册节点
clawdbot nodes list

# 检查节点状态
clawdbot nodes status living-room

# 向节点发送命令
clawdbot nodes exec living-room --cmd "play audio.mp3"

# 删除节点
clawdbot nodes remove living-room

节点发现

mDNS 发现

{
  "nodes": {
    "discovery": {
      "mdns": true,
      "subnet": "192.168.1.0/24"
    }
  }
}

手动注册

{
  "nodes": {
    "devices": [
      {
        "name": "bedroom",
        "host": "192.168.1.101",
        "port": 3012
      }
    ]
  }
}

安全性

认证

{
  "node": {
    "auth": {
      "type": "token",
      "token": "node-secret-token"
    }
  }
}

TLS

{
  "node": {
    "tls": {
      "enabled": true,
      "cert": "/path/to/cert.pem",
      "key": "/path/to/key.pem"
    }
  }
}

用例

智能家居

在整个房屋播放通知
在屏幕上显示家庭照片
控制媒体播放

办公室

会议室显示屏
音频通知
状态展示板

下一步

Clawdbot 音频节点 - 音频播放
Clawdbot 图像节点 - 图像显示
Clawdbot 网关 - 网关配置

Clawdbot 节点

On this page