配置 Clawdbot AI 助手音訊節點，用於遠端裝置上的文字轉語音和音訊播放。

Clawdbot 音訊節點概述

音訊節點使 Clawdbot 能夠透過遠端裝置的揚聲器播放音訊。使用音訊節點進行 TTS 播報、音樂播放和聲音通知。

功能特性

功能	描述
文字轉語音	將文字轉換為語音音訊
音訊檔案	播放 MP3、WAV、OGG 檔案
音量控制	調整播放音量
音訊佇列	排列多個音訊項目
音訊閃避	在語音播放時降低背景音量

配置

節點設定

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

TTS 引擎

引擎	平台	描述
`system`	全部	原生系統 TTS
`google`	全部	Google Cloud TTS
`azure`	全部	Azure 認知服務
`elevenlabs`	全部	ElevenLabs AI 語音

指令

播放音訊

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

# 播放檔案
clawdbot nodes audio kitchen-speaker --file /path/to/audio.mp3

# 調整音量
clawdbot nodes audio kitchen-speaker --volume 50

智能體指令

智能體可以使用音訊節點：

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

音訊佇列

佇列管理

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

佇列模式

模式	描述
`fifo`	先進先出
`priority`	優先順序排序
`replace`	新音訊替換佇列

音訊閃避

在播報時降低背景音訊：

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

多房間音訊

全部廣播

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

房間群組

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

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

支援格式

格式	副檔名	備註
MP3	`.mp3`	最常見
WAV	`.wav`	未壓縮
OGG	`.ogg`	開放格式
FLAC	`.flac`	無損

錯誤處理

失敗重試

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

備用裝置

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

下一步

Clawdbot 節點 - 節點概述
Clawdbot 圖像節點 - 圖像顯示
Clawdbot 閘道器 - 閘道器配置

Clawdbot 音訊節點

On this page