跳转至

文本转语音 (TTS)

OpenClaw 会将出站回复转换为飞书、Matrix、Telegram 和 WhatsApp 上的原生语音消息。所有其他渠道会收到音频附件。Telephony 和 Talk 接收 PCM 或 Ulaw 流。

TTS 是 Talk 的 stt-tts 模式中语音输出的一半（talk.speak 调用的是同一合成路径）。提供商原生的 realtime Talk 会话改为在实时提供商内部合成语音。transcription 会话永远不会合成助手的语音回复。

本页是一个索引。文本转语音（Text-to-speech）文档分为七个页面，每个页面对应一项阅读任务。请打开与你的任务匹配的页面。

页面 适用场景
文本转语音快速入门 当你需要开启 TTS、选择提供商并从聊天中测试时。
文本转语音配置 当你需要 tts 配置块、提供商代码片段、本地引擎或覆盖优先级时。
文本转语音人设 当你想要一个稳定的语音身份、其提供商绑定及回退策略时。
命令与指令 当你需要 [[tts:...]] 指令、/tts 命令，或了解本地偏好设置的位置时。
输出与自动 TTS 行为 当你需要各渠道的音频格式、转码规则，或了解 Auto-TTS 何时进行摘要时。
文本转语音字段参考 当你需要某个 TTS 字段的类型、默认值、环境变量或旧版别名时。
Agent 工具与 Gateway RPC 当你通过 agent 工具调用或 Gateway RPC 方法调用 TTS 时。

各章节迁移位置

上一版单页文档中的每个章节标题都在此处保留其锚点，因此诸如 /tools/tts#per-agent-voice-overrides 的既有链接仍可解析。每个条目指向当前包含对应内容的页面。

组件锚点

上一版单页文档还为每个步骤、标签页、折叠面板和字段生成了锚点。这些锚点在此处保留，以便指向旧页面的任何深层链接仍可解析。当共享同一 slug 的标签页移至其他页面时，九个折叠面板锚点丢失了 -1 后缀。下面的存根保留旧 id 并指向新锚点。

快速入门

配置

字段参考

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw