Providers

Gradium

Gradium — це провайдер перетворення тексту на мовлення для OpenClaw. Plugin може створювати звичайні аудіовідповіді (WAV), сумісний із голосовими нотатками вивід Opus та аудіо 8 kHz u-law для телефонних поверхонь.

Властивість	Значення
Ідентифікатор провайдера	`gradium`
Автентифікація	`GRADIUM_API_KEY` або config `apiKey`
Базова URL-адреса	`https://api.gradium.ai` (типово)
Голос за замовчуванням	`Emma` (`YTpq7expH9539ERJ`)

Установлення Plugin

Установіть офіційний Plugin, потім перезапустіть Gateway:

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

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

Створіть API-ключ Gradium, потім надайте його OpenClaw через змінну середовища або ключ конфігурації.

Змінна середовища

bash

export GRADIUM_API_KEY="gsk_..."

Ключ конфігурації

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          apiKey: "${GRADIUM_API_KEY}",        },      },    },  },}

Plugin спочатку перевіряє розв’язаний apiKey, а потім повертається до змінної середовища GRADIUM_API_KEY.

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

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          speakerVoiceId: "YTpq7expH9539ERJ",          // apiKey: "${GRADIUM_API_KEY}",          // baseUrl: "https://api.gradium.ai",        },      },    },  },}

Ключ	Тип	Опис
`messages.tts.providers.gradium.apiKey`	string	Розв’язаний API-ключ. Підтримує `${ENV}` і посилання на секрети.
`messages.tts.providers.gradium.baseUrl`	string	Перевизначає джерело API. Завершальні скісні риски видаляються. Типово `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	Ідентифікатор голосу за замовчуванням, який використовується, коли немає перевизначення директивою.

Формат вихідного аудіо автоматично вибирається середовищем виконання на основі цільової поверхні й не налаштовується з openclaw.json. Див. Вивід нижче.

Голоси

Ім’я	Ідентифікатор голосу
Emma	`YTpq7expH9539ERJ`
Kent	`LFZvm12tW_z0xfGo`
Tiffany	`Eu9iL_CYe8N-Gkx_`
Christina	`2H4HY2CBNyJHBCrP`
Sydney	`jtEKaLYNn6iif5PR`
John	`KWJiFWu2O9nMPYcR`
Arthur	`3jUdJyOi9pgbxBTK`

Голос за замовчуванням: Emma.

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

Коли активна політика мовлення дозволяє перевизначення голосу, ви можете перемикати голоси вбудовано за допомогою токена директиви. Використовуйте speakerVoiceId для нативних ідентифікаторів голосу провайдера.

text

/voice:LFZvm12tW_z0xfGo/voice_id:LFZvm12tW_z0xfGo/voiceid:LFZvm12tW_z0xfGo/gradium_voice:LFZvm12tW_z0xfGo/gradiumvoice:LFZvm12tW_z0xfGo

Якщо політика мовлення вимикає перевизначення голосу, директива споживається, але ігнорується.

Вивід

Середовище виконання вибирає формат виводу з цільової поверхні. Наразі провайдер не синтезує інші формати.

Ціль	Формат	Розширення файлу	Частота дискретизації	Прапорець сумісності з голосом
Стандартне аудіо	`wav`	`.wav`	провайдер	ні
Голосова нотатка	`opus`	`.opus`	провайдер	так
Телефонія	`ulaw_8000`	n/a	8 kHz	n/a

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

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

Пов’язане

Was this useful?