Gradium

Gradium — провайдер преобразования текста в речь для OpenClaw. Он создаёт стандартные аудиоответы (WAV), вывод Opus, совместимый с голосовыми сообщениями, и аудио u-law с частотой 8 кГц для телефонии.

Свойство	Значение
Идентификатор провайдера	`gradium`
Аутентификация	`GRADIUM_API_KEY` или конфигурация `apiKey`
Базовый URL	`https://api.gradium.ai` (по умолчанию)
Голос по умолчанию	`Emma` (`YTpq7expH9539ERJ`)

Установка плагина

Gradium — официальный внешний плагин. Установите его, затем перезапустите Gateway:

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

Настройка

Создайте API-ключ Gradium, затем укажите его с помощью переменной окружения или ключа конфигурации. Конфигурация имеет приоритет над переменной окружения.

Переменная окружения
Ключ конфигурации

export GRADIUM_API_KEY="gsk_..."

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          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`	строка	Разрешённый API-ключ. Поддерживает `${ENV}` и ссылки на секреты.
`messages.tts.providers.gradium.baseUrl`	строка	URL API Gradium по HTTPS на `api.gradium.ai`. Завершающие косые черты удаляются. По умолчанию: `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	строка	Идентификатор голоса по умолчанию, используемый при отсутствии переопределяющей директивы.

Формат вывода выбирается автоматически в зависимости от целевой поверхности (см. раздел Вывод) и не настраивается в openclaw.json.

Голоса

Имя	Идентификатор голоса
Arthur	`3jUdJyOi9pgbxBTK`
Christina	`2H4HY2CBNyJHBCrP`
Emma (по умолчанию)	`YTpq7expH9539ERJ`
John	`KWJiFWu2O9nMPYcR`
Kent	`LFZvm12tW_z0xfGo`
Sydney	`jtEKaLYNn6iif5PR`
Tiffany	`Eu9iL_CYe8N-Gkx_`

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

Если активная политика синтеза речи разрешает переопределение голоса, переключите голос непосредственно в тексте с помощью токена директивы (все следующие варианты эквивалентны и принимают нативный идентификатор голоса провайдера):

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

Если политика синтеза речи запрещает переопределение голоса, директива обрабатывается, но игнорируется.

Вывод

Формат вывода выбирается в зависимости от целевой поверхности; провайдер не синтезирует другие форматы.

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

Порядок автоматического выбора

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

Overview

Concepts and configuration

Providers

Установка плагина

Настройка

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

Голоса

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

Вывод

Порядок автоматического выбора

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

​Установка плагина

​Настройка

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

​Голоса

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

​Вывод

​Порядок автоматического выбора

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

Установка плагина

Настройка

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

Голоса

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

Вывод

Порядок автоматического выбора

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