Gradium

Gradium é um provedor de conversão de texto em fala para o OpenClaw. Ele gera respostas de áudio padrão (WAV), saída Opus compatível com mensagens de voz e áudio u-law de 8 kHz para interfaces de telefonia.

Propriedade	Valor
ID do provedor	`gradium`
Autenticação	`GRADIUM_API_KEY` ou `apiKey` na configuração
URL base	`https://api.gradium.ai` (padrão)
Voz padrão	`Emma` (`YTpq7expH9539ERJ`)

Instalar o plugin

Gradium é um plugin externo oficial. Instale-o e reinicie o Gateway:

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

Configuração inicial

Crie uma chave de API do Gradium e disponibilize-a por meio de uma variável de ambiente ou da chave de configuração. A configuração tem precedência sobre a variável de ambiente.

Variável de ambiente
Chave de configuração

export GRADIUM_API_KEY="gsk_..."

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

Configuração

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

Chave	Tipo	Descrição
`messages.tts.providers.gradium.apiKey`	string	Chave de API resolvida. Compatível com `${ENV}` e referências a segredos.
`messages.tts.providers.gradium.baseUrl`	string	URL HTTPS da API do Gradium em `api.gradium.ai`. Barras finais são removidas. Padrão: `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	ID da voz padrão usado quando não há substituição por diretiva.

O formato de saída é escolhido automaticamente de acordo com a interface de destino (consulte Saída) e não pode ser configurado em openclaw.json.

Vozes

Nome	ID da voz
Arthur	`3jUdJyOi9pgbxBTK`
Christina	`2H4HY2CBNyJHBCrP`
Emma (padrão)	`YTpq7expH9539ERJ`
John	`KWJiFWu2O9nMPYcR`
Kent	`LFZvm12tW_z0xfGo`
Sydney	`jtEKaLYNn6iif5PR`
Tiffany	`Eu9iL_CYe8N-Gkx_`

Substituição da voz por mensagem

Quando a política de fala ativa permite substituições de voz, altere a voz em linha com um token de diretiva (todas estas formas são equivalentes e recebem um ID de voz nativo do provedor):

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

Se a política de fala desativar substituições de voz, a diretiva será consumida, mas ignorada.

Saída

O formato de saída é selecionado de acordo com a interface de destino; o provedor não sintetiza outros formatos.

Destino	Formato	Extensão do arquivo	Taxa de amostragem	Indicador de compatibilidade com voz
Áudio padrão	`wav`	`.wav`	provedor	não
Mensagem de voz	`opus`	`.opus`	provedor	sim
Telefonia	`ulaw_8000`	n/d	8 kHz	n/d

Ordem de seleção automática

Entre os provedores de TTS configurados, a ordem de seleção automática do Gradium é 30. Consulte Conversão de texto em fala para saber como o OpenClaw escolhe o provedor ativo quando messages.tts.provider não está definido explicitamente.

Overview

Concepts and configuration

Providers

Instalar o plugin

Configuração inicial

Configuração

Vozes

Substituição da voz por mensagem

Saída

Ordem de seleção automática

Relacionados

​Instalar o plugin

​Configuração inicial

​Configuração

​Vozes

​Substituição da voz por mensagem

​Saída

​Ordem de seleção automática

​Relacionados

Instalar o plugin

Configuração inicial

Configuração

Vozes

Substituição da voz por mensagem

Saída

Ordem de seleção automática

Relacionados