Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Gradium — це вбудований постачальник перетворення тексту на мовлення для OpenClaw. Plugin може створювати звичайні аудіовідповіді (WAV), сумісний із голосовими нотатками вивід Opus і 8 кГц u-law аудіо для телефонних поверхонь.
ВластивістьЗначення
Ідентифікатор постачальникаgradium
АвтентифікаціяGRADIUM_API_KEY або config apiKey
Базова URL-адресаhttps://api.gradium.ai (за замовчуванням)
Голос за замовчуваннямEmma (YTpq7expH9539ERJ)

Налаштування

Створіть ключ Gradium API, а потім надайте його OpenClaw через змінну середовища або ключ конфігурації.
export GRADIUM_API_KEY="gsk_..."
Plugin спочатку перевіряє вирішений apiKey і в разі відсутності використовує змінну середовища GRADIUM_API_KEY.

Конфігурація

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          voiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
КлючТипОпис
messages.tts.providers.gradium.apiKeystringВирішений ключ API. Підтримує ${ENV} і посилання на секрети.
messages.tts.providers.gradium.baseUrlstringПеревизначає джерело API. Кінцеві скісні риски видаляються. За замовчуванням https://api.gradium.ai.
messages.tts.providers.gradium.voiceIdstringІдентифікатор голосу за замовчуванням, який використовується, коли немає перевизначення директивою.
Формат вихідного аудіо автоматично вибирається runtime на основі цільової поверхні й не налаштовується з openclaw.json. Див. Вивід нижче.

Голоси

НазваІдентифікатор голосу
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
Голос за замовчуванням: Emma.

Перевизначення голосу для окремого повідомлення

Коли активна політика мовлення дозволяє перевизначення голосу, ви можете перемикати голоси безпосередньо в тексті за допомогою токена директиви. Усі ці варіанти вирішуються в одне й те саме перевизначення voiceId:
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
Якщо політика мовлення вимикає перевизначення голосу, директива споживається, але ігнорується.

Вивід

Runtime вибирає формат виводу з цільової поверхні. Наразі постачальник не синтезує інші формати.
ЦільФорматРозширення файлуЧастота дискретизаціїПрапорець сумісності з голосом
Стандартне аудіоwav.wavпостачальникні
Голосова нотаткаopus.opusпостачальниктак
Телефоніяulaw_8000n/a8 кГцn/a

Порядок автоматичного вибору

Серед налаштованих постачальників TTS порядок автоматичного вибору Gradium дорівнює 30. Див. Перетворення тексту на мовлення, щоб дізнатися, як OpenClaw вибирає активного постачальника, коли messages.tts.provider не закріплено.

Пов’язане