Clawdbot Nodes

Clawdbot AI assistant nodes for distributed device control. Learn how to set up and manage nodes for audio, images, and remote commands.

Clawdbot Nodes Overview

Clawdbot Nodes extend your AI assistant to physical devices and remote machines. Nodes enable audio playback, image display, and command execution across your network.

What are Nodes?

Nodes are lightweight agents that run on devices:

  • Audio nodes: Play TTS and audio files
  • Image nodes: Display images on screens
  • Command nodes: Execute remote commands

Quick Start

Install Node Agent

# Install on target device
npm install -g @clawdbot/node-agent

# Start node agent
clawdbot-node start --name "living-room"

Register Node

# On main Clawdbot instance
clawdbot nodes add living-room --host 192.168.1.100 --port 3012

Node Types

Audio Nodes

Play audio through device speakers:

FeatureDescription
TTSText-to-speech playback
Audio filesMP3, WAV, OGG support
Volume controlRemote volume adjustment
QueueAudio queue management

Learn more about Audio Nodes

Image Nodes

Display images on connected screens:

FeatureDescription
DisplayShow images on screen
SlideshowAutomatic rotation
OverlaysText and graphics overlays

Learn more about Image Nodes

Configuration

Node Agent Config

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

Gateway Node Config

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

Node Commands

CLI

# List registered nodes
clawdbot nodes list

# Check node status
clawdbot nodes status living-room

# Send command to node
clawdbot nodes exec living-room --cmd "play audio.mp3"

# Remove node
clawdbot nodes remove living-room

Node Discovery

mDNS Discovery

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

Manual Registration

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

Security

Authentication

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

TLS

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

Use Cases

Smart Home

  • Play announcements throughout house
  • Display family photos on screens
  • Control media playback

Office

  • Meeting room displays
  • Audio notifications
  • Status boards

Next Steps