核心功能
feishu-audio 是一项针对飞书（Feishu）生态优化的语音消息发送技能，核心解决OpenClaw原生message工具将音频作为普通文件附件发送的痛点，实现TTS文本转语音后以可播放语音消息形式（msg_type=audio）直接呈现于聊天窗口。
显著优点
1. 原生体验优化：突破飞书API限制，通过"opus上传+audio消息类型"两步流程，让语音消息在移动端和桌面端均显示为带播放器的原生语音气泡，而非需下载的文件附件
2. 多语言音色支持：内置Azure TTS引擎，默认提供中英文男女声（XiaoyiNeural/YunxiNeural/AriaNeural/GuyNeural），满足企业通知、客服播报等场景
3. 零配置集成：凭证自动读取OpenClaw全局配置（/root/.openclaw/openclaw.json），无需额外密钥管理
4. ID类型自适应：同时支持群聊oc_xxx（chat_id）和单聊ou_xxx（open_id），receive_id_type自动处理
潜在局限
- 格式强约束：飞书API要求
file_type=opus（无论实际格式），且必须使用msg_type=audio，误配会导致234001错误或降级为文件附件 - 平台锁定：完全依赖飞书Open API，若飞书调整鉴权或消息格式需同步更新
- TTS引擎依赖：未披露离线或备用TTS方案，Azure服务异常时将中断
适用人群
- 企业运营人员：群语音公告、定时播报
- 开发者/自动化运维：集成到CI/CD流水线、监控告警语音推送
- 教育/培训场景：语音作业分发、课堂点名（语音报数）
常规风险
| 风险点 | 等级 | 说明 |
|--------|------|------|
| API凭证泄露 | 中 | 依赖全局配置文件的权限管控 |
| 语音内容审核 | 低 | TTS内容需符合飞书平台规范，敏感词可能被拦截 |
| 频率限制 | 低 | 飞书开放平台有调用额度限制 |
使用示例
# 语音报数到指定群 bash /root/.openclaw/skills/feishu-audio/scripts/send_audio.sh "今日签到人数：47人" "oc_xxx" zh-CN-YunxiNeural