将文本转为语音并通过飞书 audio 消息发送给指定用户。用于“给用户发语音”“把这段话转语音并发飞书”“语音播报结果”等场景，尤其当普通文件发送会降级为文本时使用。仅在指定 channel=feishu 时触发。优先在需要高可达、可听播报时使用。
Feishu Voice TTS
功能概述
Feishu Voice TTS是一项面向实际任务的技能，主要用于Overview；把文本转换为语音（edge-tts），再转码为飞书可用的 Opus（OGG 容器），调用飞书开放平台“先上传文件再发 audio 消息”的标准流程发送，避免“直接发文件被降级成文本”；
核心要点
- Quick Start；
- 执行脚本：；
- text （必填）要播报的文本；
使用与执行
open_id （必填，可用环境变量替代）飞书用户 open_id；voice （可选）。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Feishu Voice TTS
Overview
把文本转换为语音（edge-tts），再转码为飞书可用的 Opus（OGG 容器），调用飞书开放平台“先上传文件再发 audio 消息”的标准流程发送，避免“直接发文件被降级成文本”。
Quick Start
执行脚本：
skills/feishu-voice-tts/scripts/send_feishu_voice.sh "用户你好，这是一条语音消息" "user_open_id"
参数：
text（必填）要播报的文本open_id（必填，可用环境变量替代）飞书用户 open_idvoice（可选）edge-tts 音色，默认zh-CN-YunxiNeural
环境变量（可选，优先级高于配置文件）：
FEISHU_APP_IDFEISHU_APP_SECRETFEISHU_OPEN_IDEDGE_TTS_VOICE
Workflow
按以下顺序执行，不要跳步：
- 文本转语音：
edge-tts生成 mp3 - 转码：
ffmpeg转为audio/ogg（opus 编码，16k 单声道） - 获取 tenant token：飞书
/auth/v3/tenant_access_token/internal - 上传语音文件：飞书
/im/v1/files，拿file_key - 发送 audio 消息：飞书
/im/v1/messages，msg_type=audio+file_key
成功时脚本输出：
{"success": true, "message_id": "...", "file_key": "..."}
Requirements
ffmpeg可用edge-tts可用（脚本自动尝试以下入口）：edge-tts~/Library/Python/3.14/bin/edge-ttspython3 -m edge_tts
- 本机存在 OpenClaw 配置：
~/.openclaw/openclaw.json- 默认读取：
channels.feishu.accounts.feishu-main.appId/appSecret
- 默认读取：
Failure Handling
- 缺少依赖：按报错安装（例如
python3 -m pip install --user edge-tts） - 飞书 API 失败：脚本会直接输出原始 JSON 错误，按
code/msg排查 - 被降级成文本：确认发送的是
msg_type=audio且content里是上传后的file_key
scripts/
scripts/send_feishu_voice.sh：完整自动化脚本（TTS + 转码 + 上传 + 发送）
热门AI工具
相关专题
本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集，涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案，助你快速定位并解决Uvicorn运行中的各类问题。
0
2026.11.02
本专题汇总了Uvicorn使用教程与启动运行指南，涵盖其作为Python ASGI服务器的定位与特点，以及命令行启动（uvicorn main:app --reload）、参数配置（host/port/workers）、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧，助你快速掌握Uvicorn的运行与配置。
0
2026.11.02
本专题汇总了Uvicorn的安装配置教程与部署指南，涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载（--reload）及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧，助你快速完成Uvicorn服务的安装与上线部署。
0
2026.11.02
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
0
2026.10.28
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
0
2026.10.28
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
0
2026.10.28
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.7万人学习
共6课时 | 54.7万人学习
