Configure Clawdbot AI assistant audio nodes for text-to-speech and audio playback on remote devices.

Clawdbot Audio Nodes Overview

Audio nodes enable Clawdbot to play audio through speakers on remote devices. Use audio nodes for TTS announcements, music playback, and sound notifications.

Features

Feature	Description
Text-to-Speech	Convert text to spoken audio
Audio Files	Play MP3, WAV, OGG files
Volume Control	Adjust playback volume
Audio Queue	Queue multiple audio items
Ducking	Lower volume during speech

Configuration

Node Setup

{
  "node": {
    "name": "kitchen-speaker",
    "capabilities": ["audio"],
    "audio": {
      "device": "default",
      "volume": 80,
      "tts": {
        "engine": "system",
        "voice": "default",
        "rate": 1.0
      }
    }
  }
}

TTS Engines

Engine	Platform	Description
`system`	All	Native system TTS
`google`	All	Google Cloud TTS
`azure`	All	Azure Cognitive Services
`elevenlabs`	All	ElevenLabs AI voices

Commands

Play Audio

# Play TTS
clawdbot nodes audio kitchen-speaker --tts "Dinner is ready!"

# Play file
clawdbot nodes audio kitchen-speaker --file /path/to/audio.mp3

# Adjust volume
clawdbot nodes audio kitchen-speaker --volume 50

Agent Commands

The agent can use audio nodes:

"Play announcement on kitchen speaker: Meeting in 5 minutes"

Audio Queue

Queue Management

{
  "audio": {
    "queue": {
      "maxSize": 10,
      "mode": "fifo",
      "interruptible": true
    }
  }
}

Queue Modes

Mode	Description
`fifo`	First in, first out
`priority`	Priority-based ordering
`replace`	New audio replaces queue

Audio Ducking

Lower background audio during announcements:

{
  "audio": {
    "ducking": {
      "enabled": true,
      "duckLevel": 20,
      "fadeTime": 500
    }
  }
}

Multi-Room Audio

Broadcast to All

clawdbot nodes audio --all --tts "Announcement for everyone"

Room Groups

{
  "nodes": {
    "groups": {
      "downstairs": ["kitchen", "living-room"],
      "upstairs": ["bedroom", "office"]
    }
  }
}

clawdbot nodes audio --group downstairs --tts "Hello downstairs"

Supported Formats

Format	Extension	Notes
MP3	`.mp3`	Most common
WAV	`.wav`	Uncompressed
OGG	`.ogg`	Open format
FLAC	`.flac`	Lossless

Error Handling

Retry on Failure

{
  "audio": {
    "retry": {
      "maxAttempts": 3,
      "delay": 1000
    }
  }
}

Fallback Device

{
  "audio": {
    "fallback": "living-room"
  }
}

Next Steps

Clawdbot Nodes - Node overview
Clawdbot Image Nodes - Image display
Clawdbot Gateway - Gateway configuration

Clawdbot Audio Nodes

On this page