Pular para o conteúdo principal
Gradium é um provedor de texto para fala para o OpenClaw. O Plugin pode renderizar respostas normais em áudio (WAV), saída Opus compatível com notas de voz e áudio u-law de 8 kHz para superfícies de telefonia.
PropriedadeValor
ID do provedorgradium
AutenticaçãoGRADIUM_API_KEY ou config apiKey
URL basehttps://api.gradium.ai (padrão)
Voz padrãoEmma (YTpq7expH9539ERJ)

​
Instalar Plugin

Instale o Plugin oficial e depois reinicie o Gateway: 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
Configuração

Crie uma chave de API do Gradium e depois exponha-a ao OpenClaw com uma variável de ambiente ou com a chave de configuração. 
export GRADIUM_API_KEY="gsk_..."
O Plugin verifica primeiro o apiKey resolvido e recorre à variável de ambiente GRADIUM_API_KEY.

​
Configuração

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
ChaveTipoDescrição
messages.tts.providers.gradium.apiKeystringChave de API resolvida. Compatível com ${ENV} e referências a secrets.
messages.tts.providers.gradium.baseUrlstringSubstitui a origem da API. Barras finais são removidas. O padrão é https://api.gradium.ai.
messages.tts.providers.gradium.speakerVoiceIdstringID da voz padrão usado quando não há substituição por diretiva presente.
O formato de áudio de saída é selecionado automaticamente pelo runtime com base na superfície de destino e não é configurável em openclaw.json. Veja Saída abaixo.

​
Vozes

NomeID da voz
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
Voz padrão: Emma.

​
Substituição de voz por mensagem

Quando a política de fala ativa permite substituições de voz, você pode trocar vozes inline usando um token de diretiva. Use speakerVoiceId para IDs de voz nativos 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 desabilitar substituições de voz, a diretiva é consumida, mas ignorada.

​
Saída

O runtime escolhe o formato de saída a partir da superfície de destino. Atualmente, o provedor não sintetiza outros formatos.
DestinoFormatoExt. do arquivoTaxa de amostragemSinalizador compatível com voz
Áudio padrãowav.wavprovedornão
Nota de vozopus.opusprovedorsim
Telefoniaulaw_8000n/d8 kHzn/d

​
Ordem de seleção automática

Entre os provedores de TTS configurados, a ordem de seleção automática do Gradium é 30. Veja Texto para fala para saber como o OpenClaw escolhe o provedor ativo quando messages.tts.provider não está fixado.

​
Relacionados