本页内容
本页内容
工具
文本转语音快速入门
快速开始
选择提供商
OpenAI 和 ElevenLabs 是最可靠的托管选项。Microsoft 和 Local CLI 无需 API 密钥。请查看 提供商矩阵 获取完整列表。
设置API密钥
为你的提供商导出环境变量（例如 OPENAI_API_KEY、 ELEVENLABS_API_KEY）。Microsoft 和 Local CLI 不需要密钥。
在配置中启用
设置 tts.auto: "always" 和 tts.provider：
在聊天中尝试一下
/tts status 会显示当前状态。/tts audio Hello from OpenClaw 会发送一次性的音频回复。
支持的提供商
| 提供者 | 认证 | 笔记 |
|---|---|---|
| Azure Speech | AZURE_SPEECH_KEY + AZURE_SPEECH_REGION（也支持 AZURE_SPEECH_API_KEY、SPEECH_KEY、SPEECH_REGION） |
原生 Ogg/Opus 语音消息输出和电话功能。 |
| DeepInfra | DEEPINFRA_API_KEY |
OpenAI-兼容TTS。默认为 hexgrad/Kokoro-82M。 |
| ElevenLabs | ELEVENLABS_API_KEY 或 XI_API_KEY |
语音克隆，多语言，可通过 seed 重复；用于 Discord 语音播放的流式传输。 |
| Fish Audio | FISH_API_KEY 或 FISH_AUDIO_API_KEY |
托管式 S2.1 TTS、表现力标签、语音发现、流式传输和电话功能。 |
| Google Gemini | GEMINI_API_KEY 或 GOOGLE_API_KEY |
Gemini API TTS；选择加入 Gemini 3.8，其中角色风格是元数据，而不是语音文本。 |
| Gradium | GRADIUM_API_KEY |
语音消息和电话输出。 |
| Inworld | INWORLD_API_KEY |
流式 TTS API。原生 Opus 语音消息和 PCM 电话功能。 |
| 本地 CLI | 无 | 运行配置的本地 TTS 命令。 |
| Microsoft | 无 | 通过 node-edge-tts 提供公开的 Edge 神经网络 TTS。尽力而为，不提供 SLA。 |
| MiniMax | MINIMAX_API_KEY（或 Token 方案：MINIMAX_OAUTH_TOKEN、MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY） |
T2A v2 API。默认为 speech-2.8-hd。 |
| OpenAI | OPENAI_API_KEY |
也用于自动摘要；支持 persona instructions。 |
| OpenRouter | OPENROUTER_API_KEY（可复用 models.providers.openrouter.apiKey） |
默认模型为 hexgrad/kokoro-82m。 |
| Volcengine | VOLCENGINE_TTS_API_KEY 或 BYTEPLUS_SEED_SPEECH_API_KEY（旧版 AppID/token：VOLCENGINE_TTS_APPID/_TOKEN） |
BytePlus 种子演讲 HTTP API。 |
| Vydra | VYDRA_API_KEY |
共享的图像、视频和语音提供商。 |
| xAI | XAI_API_KEY |
xAI 批次 TTS。本机 Opus 语音注释是 不支持。 |
| Xiaomi MiMo | XIAOMI_API_KEY |
通过小米聊天补全使用 MiMo TTS。 |
如果配置了多个提供商，将首先使用当前选中的那个，其余作为回退选项。自动摘要使用 summaryModel（或 agents.defaults.model.primary），因此如果你保持摘要功能开启，该提供商也必须已完成认证。
本页有帮助吗？