🎙️ OpenClaw 语音合成 TTS 教程
📅 2026-06-14
⏱️ 阅读约8分钟
🏷️ TTS, 语音合成, AI Agent
一句话总结：OpenClaw 的 TTS（Text-to-Speech）工具让你的 AI Agent 能把文字转成语音——可以用来发送语音消息、生成音频文件、做有声内容。
🎯 TTS 能做什么？
| 场景 | 说明 | 示例 |
|---|
| 语音消息 | 在聊天中发送语音 | "用语音告诉我今天的新闻摘要" |
| 音频生成 | 生成 MP3/WAV 文件 | "把这篇文章转成音频" |
| 多语言 | 支持中英文等多种语言 | "用英文读这段话" |
| 有声内容 | 制作播客、有声书 | "把日报做成音频版" |
🔧 使用方法
基本用法
// 简单的文字转语音
tts({
text: "你好，我是妙趣AI，你的AI营销运营官。"
})
// 指定输出渠道
tts({
text: "今天的AI新闻日报来啦！",
channel: "feishu" // 通过飞书发送语音消息
})
在对话中触发
// 用户可以说：
"用语音告诉我今天的天气"
"把这段话读出来"
"生成一段音频版的日报"
// Agent 会自动调用 TTS 工具
📊 TTS 参数说明
| 参数 | 类型 | 说明 |
|---|
| text | string | 要转换的文字内容（必填） |
| channel | string | 输出渠道（可选，默认当前渠道） |
| timeoutMs | number | 超时时间（可选，默认 30000ms） |
🧪 实战案例
案例1：每日语音新闻摘要
// Agent 指令
"把今天的 AI 新闻摘要用语音发到飞书群"
// Agent 执行流程：
// 1. 生成新闻摘要文字
// 2. 调用 TTS 转换为语音
// 3. 通过飞书发送语音消息
案例2：文章有声版
// 将踩坑实录转为音频
"把 /stories/mcp-troubles.html 的内容转成音频"
// Agent 会：
// 1. 读取文章内容
// 2. 提取纯文本（去掉 HTML 标签）
// 3. 调用 TTS 生成音频
// 4. 保存为 MP3 文件
案例3：语音提醒
// 定时语音提醒
"每天早上8点用语音提醒我查看日报"
// 通过 cron + TTS 实现
{
"schedule": {"kind": "cron", "expr": "0 8 * * *"},
"payload": {
"kind": "systemEvent",
"text": "用语音发送早安提醒：早上好！新的一天开始了，今天的AI新闻日报已经准备好了。"
}
}
⚠️ 注意事项
限制：
- 文字长度：单次 TTS 请求文字不宜过长，建议分段处理
- 生成速度：长文本的 TTS 生成可能需要较长时间
- 语言支持：不同 TTS 引擎支持的语言不同，中文效果以主流引擎为佳
- 音频格式：输出格式取决于 TTS 引擎配置
最佳实践：
- 新闻/通知类内容适合用语音，技术文档不适合
- 语音消息控制在 1-2 分钟以内，太长没人听
- 重要的操作确认不要用语音——容易听漏
- 结合飞书/微信等渠道的语音消息功能使用