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 3012Node Types
Audio Nodes
Play audio through device speakers:
| Feature | Description |
|---|---|
| TTS | Text-to-speech playback |
| Audio files | MP3, WAV, OGG support |
| Volume control | Remote volume adjustment |
| Queue | Audio queue management |
Image Nodes
Display images on connected screens:
| Feature | Description |
|---|---|
| Display | Show images on screen |
| Slideshow | Automatic rotation |
| Overlays | Text and graphics overlays |
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-roomNode 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
- Clawdbot Audio Nodes - Audio playback
- Clawdbot Image Nodes - Image display
- Clawdbot Gateway - Gateway configuration