Pular para o conteúdo principal
Azure Speech é um provedor de conversão de texto em fala do Azure AI Speech. No OpenClaw, ele sintetiza áudio de respostas de saída como MP3 por padrão, Ogg/Opus nativo para notas de voz e áudio mulaw de 8 kHz para canais de telefonia, como Chamada de voz. O OpenClaw usa a API REST do Azure Speech diretamente com SSML e envia o formato de saída pertencente ao provedor por meio de X-Microsoft-OutputFormat.
DetalheValor
SiteAzure AI Speech
DocumentaçãoREST de fala para texto do Speech
AutenticaçãoAZURE_SPEECH_KEY mais AZURE_SPEECH_REGION
Voz padrãoen-US-JennyNeural
Saída de arquivo padrãoaudio-24khz-48kbitrate-mono-mp3
Arquivo padrão de nota de vozogg-24khz-16bit-mono-opus

​
Primeiros passos

1

Create an Azure Speech resource

No portal do Azure, crie um recurso Speech. Copie KEY 1 em Resource Management > Keys and Endpoint e copie a localização do recurso, como eastus.
AZURE_SPEECH_KEY=<speech-resource-key>
AZURE_SPEECH_REGION=eastus
2

Select Azure Speech in messages.tts

{
  messages: {
    tts: {
      auto: "always",
      provider: "azure-speech",
      providers: {
        "azure-speech": {
          speakerVoice: "en-US-JennyNeural",
          lang: "en-US",
        },
      },
    },
  },
}
3

Send a message

Envie uma resposta por qualquer canal conectado. O OpenClaw sintetiza o áudio com o Azure Speech e entrega MP3 para áudio padrão, ou Ogg/Opus quando o canal espera uma nota de voz.

​
Opções de configuração

OpçãoCaminhoDescrição
apiKeymessages.tts.providers.azure-speech.apiKeyChave do recurso Azure Speech. Usa como fallback AZURE_SPEECH_KEY, AZURE_SPEECH_API_KEY ou SPEECH_KEY.
regionmessages.tts.providers.azure-speech.regionRegião do recurso Azure Speech. Usa como fallback AZURE_SPEECH_REGION ou SPEECH_REGION.
endpointmessages.tts.providers.azure-speech.endpointSubstituição opcional de endpoint/URL base do Azure Speech.
baseUrlmessages.tts.providers.azure-speech.baseUrlSubstituição opcional da URL base do Azure Speech.
speakerVoicemessages.tts.providers.azure-speech.speakerVoiceShortName da voz do Azure (padrão en-US-JennyNeural). Alias legado: voice.
langmessages.tts.providers.azure-speech.langCódigo de idioma SSML (padrão en-US).
outputFormatmessages.tts.providers.azure-speech.outputFormatFormato de saída do arquivo de áudio (padrão audio-24khz-48kbitrate-mono-mp3).
voiceNoteOutputFormatmessages.tts.providers.azure-speech.voiceNoteOutputFormatFormato de saída de nota de voz (padrão ogg-24khz-16bit-mono-opus).

​
Observações

O Azure Speech usa uma chave de recurso Speech, não uma chave do Azure OpenAI. A chave é enviada como Ocp-Apim-Subscription-Key; o OpenClaw deriva https://<region>.tts.speech.microsoft.com de region, a menos que você forneça endpoint ou baseUrl.
Use o valor ShortName da voz do Azure Speech, por exemplo en-US-JennyNeural. O provedor incluído pode listar vozes por meio do mesmo recurso Speech e filtra vozes marcadas como obsoletas ou retiradas.
O Azure aceita formatos de saída como audio-24khz-48kbitrate-mono-mp3, ogg-24khz-16bit-mono-opus e riff-24khz-16bit-mono-pcm. O OpenClaw solicita Ogg/Opus para destinos voice-note, para que os canais possam enviar bolhas de voz nativas sem uma conversão extra para MP3.
azure é aceito como alias de provedor para PRs existentes e configuração do usuário, mas novas configurações devem usar azure-speech para evitar confusão com provedores de modelos Azure OpenAI.

​
Relacionado

Text-to-speech

Visão geral de TTS, provedores e configuração de messages.tts.

Configuration

Referência completa de configuração, incluindo definições de messages.tts.

Providers

Todos os provedores incluídos no OpenClaw.

Troubleshooting

Problemas comuns e etapas de depuração.