Use this file to discover all available pages before exploring further.

Azure Speech

Azure Speech is an Azure AI Speech text-to-speech provider. In OpenClaw it synthesizes outbound reply audio as MP3 by default, native Ogg/Opus for voice notes, and 8 kHz mulaw audio for telephony channels such as Voice Call.

OpenClaw uses the Azure Speech REST API directly with SSML and sends the provider-owned output format through

text

X-Microsoft-OutputFormat

Detail	Value
Website	Azure AI Speech
Docs	Speech REST text-to-speech
Auth	text `AZURE_SPEECH_KEY` plus text `AZURE_SPEECH_REGION`
Default voice	text `en-US-JennyNeural`
Default file output	text `audio-24khz-48kbitrate-mono-mp3`
Default voice-note file	text `ogg-24khz-16bit-mono-opus`

Getting started

Create an Azure Speech resource

In the Azure portal, create a Speech resource. Copy **KEY 1** from Resource Management > Keys and Endpoint, and copy the resource location such as `eastus`.


text
```
AZURE_SPEECH_KEY=<speech-resource-key>
AZURE_SPEECH_REGION=eastus
```

Select Azure Speech in messages.tts

```json5} { messages: { tts: { auto: "always", provider: "azure-speech", providers: { "azure-speech": { voice: "en-US-JennyNeural", lang: "en-US", }, }, }, }, } ```

Send a message

Send a reply through any connected channel. OpenClaw synthesizes the audio with Azure Speech and delivers MP3 for standard audio, or Ogg/Opus when the channel expects a voice note.

Configuration options

Option	Path	Description
text `apiKey`	text `messages.tts.providers.azure-speech.apiKey`	Azure Speech resource key. Falls back to text `AZURE_SPEECH_KEY` , text `AZURE_SPEECH_API_KEY` , or text `SPEECH_KEY` .
text `region`	text `messages.tts.providers.azure-speech.region`	Azure Speech resource region. Falls back to text `AZURE_SPEECH_REGION` or text `SPEECH_REGION` .
text `endpoint`	text `messages.tts.providers.azure-speech.endpoint`	Optional Azure Speech endpoint/base URL override.
text `baseUrl`	text `messages.tts.providers.azure-speech.baseUrl`	Optional Azure Speech base URL override.
text `voice`	text `messages.tts.providers.azure-speech.voice`	Azure voice ShortName (default text `en-US-JennyNeural` ).
text `lang`	text `messages.tts.providers.azure-speech.lang`	SSML language code (default text `en-US` ).
text `outputFormat`	text `messages.tts.providers.azure-speech.outputFormat`	Audio-file output format (default text `audio-24khz-48kbitrate-mono-mp3` ).
text `voiceNoteOutputFormat`	text `messages.tts.providers.azure-speech.voiceNoteOutputFormat`	Voice-note output format (default text `ogg-24khz-16bit-mono-opus` ).

Notes

Text-to-speech

TTS overview, providers, and `messages.tts` config.

Configuration

Full config reference including `messages.tts` settings.

Providers

All bundled OpenClaw providers.

Troubleshooting

Common issues and debugging steps.

OpenClaw Docs