feishu-voice-note（飞书语音笔记）

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 send 发送语音条：

openclaw message send \
    --channel feishu \
    --account main \
    --target "user:ou_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
    --media "voice.opus"

参数说明：

⚠️ 重要： --target 参数需要替换为实际的用户 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 send]
    E --> F[回复 NO_REPLY]

技术配置

前置条件

1. ffmpeg 已安装

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

1. OpenClaw 配置

- TTS Provider 已配置（Edge TTS / OpenAI TTS） - 飞书渠道已启用

1. 依赖

- Node.js 18+ - OpenClaw 2026.3.13+

错误处理

常见错误及解决方案

错误 1：ffmpeg 未找到

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

错误 2：Open ID 格式错误

错误：Invalid target format
解决：确保格式为 user:ou_XXX（32 字符）

错误 3：文件不存在

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

适用范围

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

例外情况

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

最佳实践

1. TTS 文本长度控制

• 推荐： 150 字以内（约 30-60 秒）
• 过长处理： 分段生成多个语音条

2. 文件清理

发送后清理临时文件：

Remove-Item "voice.mp3" -Force
Remove-Item "voice.opus" -Force

3. 错误重试

发送失败时重试 1 次：

# 重试逻辑
if (!$?) {
    Start-Sleep -Seconds 2
    openclaw message send --channel feishu --account main --target "user:ou_XXX" --media "voice.opus"
}

版本历史

参考资源

• OpenClaw 官方文档：https://openclaw.dev/
• 飞书语音消息 API 文档：https://[你的租户].feishu.cn/docx/XXX
• ffmpeg 官方文档：https://ffmpeg.org/documentation.html

许可证

MIT License

维护者

阿美团队（OpenClaw Community）