Gradium - OpenClaw

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:

openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

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

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

Змінна середовища
Ключ конфігурації

export GRADIUM_API_KEY="gsk_..."

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

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

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

{
  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 для нативних ідентифікаторів голосу провайдера.

/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 не закріплено.

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

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

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

​Голоси

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

​Вивід

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

​Пов’язане