Providers

Azure 語音服務

Azure Speech 是內建的 Azure AI Speech 文字轉語音提供者。OpenClaw 會透過 SSML 直接呼叫 Azure Speech REST API，為標準回覆合成 MP3、為語音訊息合成原生 Ogg/Opus，並為 Voice Call 等電話語音通道合成 8 kHz mulaw。請求會透過 X-Microsoft-OutputFormat 標頭傳送由提供者擁有的輸出格式。

詳細資料	值
提供者 ID	`azure-speech`（別名：`azure`）
網站	Azure AI Speech
文件	Speech REST 文字轉語音
驗證	`AZURE_SPEECH_KEY` 加上 `AZURE_SPEECH_REGION`
預設語音	`en-US-JennyNeural`
預設檔案輸出	`audio-24khz-48kbitrate-mono-mp3`
預設語音訊息檔案	`ogg-24khz-16bit-mono-opus`

開始使用

建立 Azure Speech 資源

在 Azure 入口網站中建立 Speech 資源。從 Resource Management > Keys and Endpoint 複製 KEY 1，並複製資源位置，例如 eastus。

Code

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

在 messages.tts 中選取 Azure Speech

json5

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

傳送訊息

透過任何已連線的通道傳送回覆。OpenClaw 會使用 Azure Speech 合成音訊，並為標準音訊傳送 MP3；當通道需要語音訊息時，則傳送 Ogg/Opus。

設定選項

所有選項都位於 messages.tts.providers["azure-speech"] 之下。

選項	說明
`apiKey`	Azure Speech 資源金鑰。若未設定，則依序使用 `AZURE_SPEECH_KEY`、`AZURE_SPEECH_API_KEY` 或 `SPEECH_KEY`。
`region`	Azure Speech 資源區域。若未設定，則使用 `AZURE_SPEECH_REGION` 或 `SPEECH_REGION`。
`endpoint`	選用的 Azure Speech 端點覆寫。若未設定，則使用受信任的 `AZURE_SPEECH_ENDPOINT`。
`baseUrl`	選用的 Azure Speech 基礎 URL 覆寫。
`voice`	Azure 語音 ShortName（預設為 `en-US-JennyNeural`）。舊版別名：`voiceId`。
`lang`	SSML 語言代碼（預設為 `en-US`）。
`outputFormat`	音訊檔案輸出格式（預設為 `audio-24khz-48kbitrate-mono-mp3`）。
`voiceNoteOutputFormat`	語音訊息輸出格式（預設為 `ogg-24khz-16bit-mono-opus`）。
`timeoutMs`	以毫秒為單位的請求逾時覆寫。若未設定，則使用全域 `messages.tts.timeoutMs`。

設定 apiKey，並同時設定 region、 endpoint 或 baseUrl 其中之一後，即視為已完成提供者設定。只有在設定鍵未設定時，才會檢查環境變數作為備援。工作區的 .env 檔案無法設定 AZURE_SPEECH_ENDPOINT；端點路由請使用程序環境、全域執行階段 dotenv 或明確設定。

注意事項

驗證

Azure Speech 使用 Speech 資源金鑰，而非 Azure OpenAI 金鑰。金鑰會以 Ocp-Apim-Subscription-Key 傳送；除非你提供 endpoint 或 baseUrl，否則 OpenClaw 會從 region 衍生 https://<region>.tts.speech.microsoft.com。

語音名稱

使用 Azure Speech 語音的 ShortName 值，例如 en-US-JennyNeural。內建提供者可透過相同的 Speech 資源列出語音，並篩除標記為已淘汰、已停用或已關閉的語音。

音訊輸出

Azure 接受 audio-24khz-48kbitrate-mono-mp3、ogg-24khz-16bit-mono-opus 和 riff-24khz-16bit-mono-pcm 等輸出格式。OpenClaw 會為 voice-note 目標要求 Ogg/Opus，讓通道無須額外轉換 MP3 即可傳送原生語音訊息泡泡；對電話語音目標則強制使用 raw-8khz-8bit-mono-mulaw。

別名

為相容現有設定，azure 可作為提供者別名，但新設定應使用 azure-speech，以免與 Azure OpenAI 模型提供者混淆。