🎙️ 飞书语音条生成

feishu-voice-note 技能 描述

飞书原生语音条（语音条）生成工具。使用场景：用户要求发送语音条、需要将 TTS 转为 OPUS 格式、飞书语音消息自动化。支持 OpenAI/Edge TTS、ffmpeg 转换、自动发送。

触发词 "发送语音条" "用语音回复" "语音消息" "语音条" "TTS 转语音" 执行流程 步骤 1：TTS 生成 MP3

调用 tts 工具生成 MP3 音频：

# 使用 OpenClaw 内置 tts 工具 tts --text "要转换的文本内容" --channel feishu

输出： MP3 文件路径（如 voice.mp3）

步骤 2：ffmpeg 转换为 OPUS 32k

使用 ffmpeg 将 MP3 转换为飞书支持的 OPUS 格式：

# Windows PowerShell & "C:\ffmpeg\ffmpeg-8.1-essentials_build\bin\ffmpeg.exe" -i "voice.mp3" -c:a libopus -b:a 32k "voice.opus" -y

参数说明：

-i voice.mp3 - 输入 MP3 文件 -c:a libopus - 使用 OPUS 编码器 -b:a 32k - 比特率 32kbps（飞书推荐） -y - 覆盖已存在的文件

输出： OPUS 文件路径（如 voice.opus）

步骤 3：发送语音条到飞书

使用 OpenClaw message 发送 发送语音条：

OpenClaw message 发送 \ --channel feishu \ --account mAIn \ --tar获取 "user:ou_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \ --media "voice.opus"

参数说明：

参数 值 说明 --channel feishu 指定飞书渠道 --account mAIn 使用主账号配置 --tar获取 user:ou_XXX 目标用户 Open ID（需要替换为实际用户 ID） --media 文件路径 OPUS 音频文件路径

⚠️ 重要： --tar获取 参数需要替换为实际的用户 Open ID，格式为 user:ou_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

步骤 4：回复 NO_REPLY

发送语音条后，回复 NO_REPLY 避免重复消息：

NO_REPLY

完整流程图 graph TB A[准备回答] --> B[正常文本回复] B --> C[TTS 生成 MP3] C --> D[ffmpeg 转 OPUS 32k] D --> E[OpenClaw message 发送] E --> F[回复 NO_REPLY]

技术配置 前置条件

ffmpeg 已安装

Windows: C:\ffmpeg\ffmpeg-8.1-essentials_build\bin\ffmpeg.exe macOS: /usr/local/bin/ffmpeg Linux: /usr/bin/ffmpeg

OpenClaw 配置

TTS 提供者 已配置（Edge TTS / OpenAI TTS） 飞书渠道已启用

依赖

Node.js 18+ OpenClaw 2026.3.13+ 错误处理 常见错误及解决方案

错误 1：ffmpeg 未找到

错误：'ffmpeg' 不是内部或外部命令 解决：安装 ffmpeg 并添加到 PATH

错误 2：Open ID 格式错误

错误：Invalid tar获取 格式化 解决：确保格式为 user:ou_XXX（32 字符）

错误 3：文件不存在

错误：File not found: voice.opus 解决：检查 ffmpeg 转换是否成功，文件路径是否正确

适用范围

✅ 所有回答 - 无论长短、简单/复杂 ✅ 所有场景 - 个人聊天、群聊、子会话 ✅ 所有 代理 - 阿美、阿香、阿丽、dev、content、ops 等

例外情况

❌ 心跳确认 - HEARTBEAT_OK 不需要语音 ❌ NO_REPLY 回复 - 已经发送语音后不需要再次发送

最佳实践

• TTS 文本长度控制

• 文件清理

发送后清理临时文件：

移除-Item "voice.mp3" -Force 移除-Item "voice.opus" -Force

• 错误重试

发送失败时重试 1 次：

# 重试逻辑 if (!$?) { 启动-Sleep -Seconds 2 OpenClaw message 发送 --channel feishu --account mAIn --tar获取 "user:ou_XXX" --media "voice.opus" }

版本历史 版本 日期 变更 v1.0 2026-03-18 初始版本 v1.1 2026-03-29 修复命令格式，添加 --channel 和 --account 参数 参考资源 OpenClaw 官方文档：https://OpenClaw.dev/ 飞书语音消息 API 文档：https://[你的租户].feishu.cn/docx/XXX ffmpeg 官方文档：https://ffmpeg.org/documentation.html 许可证

MIT License

维护者

阿美团队（OpenClaw Community）