Перейти к основному содержанию
Gradium — провайдер преобразования текста в речь для OpenClaw. Plugin может создавать обычные аудиоответы (WAV), совместимый с голосовыми заметками вывод Opus и 8 кГц u-law-аудио для телефонных поверхностей.
СвойствоЗначение
ID провайдераgradium
АутентификацияGRADIUM_API_KEY или config apiKey
Базовый URLhttps://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_..."
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.apiKeystringРазрешенный API-ключ. Поддерживает ${ENV} и ссылки на секреты.
messages.tts.providers.gradium.baseUrlstringПереопределяет origin API. Завершающие косые черты удаляются. По умолчанию https://api.gradium.ai.
messages.tts.providers.gradium.speakerVoiceIdstringID голоса по умолчанию, используемый при отсутствии переопределения директивой.
Формат выходного аудио автоматически выбирается средой выполнения на основе целевой поверхности и не настраивается из openclaw.json. См. Вывод ниже.

​
Голоса

ИмяID голоса
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
Голос по умолчанию: Emma.

​
Переопределение голоса для сообщения

Когда активная политика речи разрешает переопределения голоса, можно переключать голоса прямо в тексте с помощью токена директивы. Используйте speakerVoiceId для нативных ID голосов провайдера. 
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
Если политика речи отключает переопределения голоса, директива потребляется, но игнорируется.

​
Вывод

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

​
Порядок автовыбора

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

​
Связанные материалы