Azure AI Speech 是 OpenClaw 的 TTS（文字转语音）提供商，基于 Azure Cognitive Services Speech SDK。Provider ID 为 azure-speech，别名 azure（兼容旧配置）。
核心属性
| 属性 | 值 |
|---|---|
| Provider ID | azure-speech（别名：azure） |
| 功能 | TTS（文字转语音） |
| 认证 | AZURE_SPEECH_KEY + AZURE_SPEECH_REGION |
| 默认语音 | en-US-JennyNeural |
认证配置
export AZURE_SPEECH_KEY="your-azure-speech-key"
export AZURE_SPEECH_REGION="eastus"输出格式
| 格式 | 用途 | 说明 |
|---|---|---|
| MP3 | 默认 | 通用音频输出 |
| Ogg/Opus | Voice Note | 适合消息语音 |
| 8kHz mulaw | 电话 | PSTN/电话系统兼容 |
配置路径
在 OpenClaw 配置文件中，TTS provider 配置位于：
{
messages: {
tts: {
providers: {
"azure-speech": {
voice: "zh-CN-XiaoxiaoNeural", // 覆盖默认语音
region: "eastasia",
},
},
},
},
}常用 Neural 语音
| 语音 ID | 语言 | 风格 |
|---|---|---|
en-US-JennyNeural | 英语（美国） | 默认，自然对话 |
zh-CN-XiaoxiaoNeural | 中文（普通话） | 自然，多风格 |
zh-CN-YunxiNeural | 中文（普通话） | 男声 |
完整语音列表参考 Azure Neural Voices。
别名兼容性
旧配置中使用 azure 作为 provider ID 的仍然有效，OpenClaw 自动映射到 azure-speech。
关联页面
- providers — 所有 Provider 概览
- docs/channels/voice — 语音频道配置与 TTS 集成