by 运行时依赖
安装命令
点击复制技能文档
Feishu Voice TTS Overview
把文本转换为语音（edge-tts），再转码为飞书可用的 Opus（OGG 容器），调用飞书开放平台“先上传文件再发 audio 消息”的标准流程发送，避免“直接发文件被降级成文本”。
Quick 启动
执行脚本：
技能s/feishu-voice-tts/scripts/发送_feishu_voice.sh "用户你好，这是一条语音消息" "user_open_id"
参数：
text（必填）要播报的文本 open_id（必填，可用环境变量替代）飞书用户 open_id voice（可选）edge-tts 音色，默认 zh-CN-YunxiNeural
环境变量（可选，优先级高于配置文件）：
FEISHU_应用_ID FEISHU_应用_SECRET FEISHU_OPEN_ID EDGE_TTS_VOICE 工作流
按以下顺序执行，不要跳步：
文本转语音：edge-tts 生成 mp3 转码：ffmpeg 转为 audio/ogg（opus 编码，16k 单声道） 获取 tenant 令牌：飞书 /auth/v3/tenant_访问_令牌/internal 上传语音文件：飞书 /im/v1/files，拿 file_key 发送 audio 消息：飞书 /im/v1/messages，msg_type=audio + file_key
成功时脚本输出：
{"成功": true, "message_id": "...", "file_key": "..."}
Requirements ffmpeg 可用 edge-tts 可用（脚本自动尝试以下入口）： edge-tts ~/库/Python/3.14/bin/edge-tts python3 -m edge_tts 本机存在 OpenClaw 配置：~/.OpenClaw/OpenClaw.json 默认读取：channels.feishu.accounts.feishu-mAIn.应用Id/应用Secret 失败 Handling 缺少依赖：按报错安装（例如 python3 -m pip 安装 --user edge-tts） 飞书 API 失败：脚本会直接输出原始 JSON 错误，按 code/msg 排查 被降级成文本：确认发送的是 msg_type=audio 且 content 里是上传后的 file_key scripts/ scripts/发送_feishu_voice.sh：完整自动化脚本（TTS + 转码 + 上传 + 发送）