飞书语音发送器(TTS) Feishu Voice Sender
by @sunxq1017-hash
飞书语音发送器 | Feishu Voice Sender 支持 TTS 语音合成,以及可选的 ASR 语音识别功能。 当用户明确要求发送飞书语音消息时调用此工具,例如:发语音、用语音回复、发送语音消息等。 This skill may be invoked only when the user explicit...
clawhub install feishu-voice-sender-tts📖 About This Skill
name: feishu-voice-sender-tts description: | 飞书语音发送器 | Feishu Voice Sender 支持 TTS 语音合成,以及可选的 ASR 语音识别功能。 当用户明确要求发送飞书语音消息时调用此工具,例如:发语音、用语音回复、发送语音消息等。 This skill may be invoked only when the user explicitly requests a voice message via Feishu/Lark. It does not run automatically.
metadata: openclaw: primaryEnv: FEISHU_APP_SECRET requires: env: - TTS_APP_ID - TTS_ACCESS_KEY - FEISHU_APP_ID - FEISHU_APP_SECRET bins: - ffmpeg env: - name: TTS_APP_ID description: "Volcengine TTS app ID" required: true sensitive: false - name: TTS_ACCESS_KEY description: "Volcengine TTS access key" required: true sensitive: true - name: FEISHU_APP_ID description: "Feishu app ID" required: true sensitive: false - name: FEISHU_APP_SECRET description: "Feishu app secret" required: true sensitive: true - name: ASR_APP_ID description: "Volcengine ASR app ID (optional, only needed for speech recognition)" required: false sensitive: false - name: ASR_ACCESS_KEY description: "Volcengine ASR access key (optional, only needed for speech recognition)" required: false sensitive: true - name: DEFAULT_RECEIVE_ID description: "Default Feishu open_id for the recipient" required: false sensitive: false - name: ASR_RESOURCE_ID description: "Volcengine ASR resource ID for local-file recognition (optional, defaults to the flash/local-file ASR resource)" required: false sensitive: false
飞书语音发送器 Feishu Voice Sender
支持 TTS 语音合成,以及可选的 ASR 语音识别功能,同时支持基于上下文的情绪参数。
⚠️ 重要声明
执行模式 | Execution Model
外部依赖 | External Dependencies
触发场景 | Invocation Examples
当用户明确要求发送飞书语音消息时,可调用此 Skill,例如:
This skill may be invoked only when the user explicitly requests a voice message via Feishu/Lark. It does not run automatically.
AI 使用方法
当用户明确要求时,使用以下方式发送语音:
import sys
sys.path.insert(0, 'src')
from feishu_voice import send_voice_message发送语音消息
send_voice_message(
text="要播报的内容",
user_input="用户的原始请求(用于情绪感知)"
)
参数说明:
text: AI 生成的播报内容(必填,最大 300 字符)user_input: 用户的原始输入,用于让豆包感知情绪(可选)receive_id: 接收者 ID(可选,默认从环境变量读取)示例:
# 用户说:"用激动的语气发语音说项目成功了"
send_voice_message(
text="项目成功了!我们超额完成了目标!",
user_input="用激动的语气发语音说项目成功了"
)
数据流 | Data Flow
Text path: 用户提供文本 → 情绪上下文参数 → TTS 语音合成 → 格式转换 → 飞书发送
ASR path:
用户明确提供本地音频文件(当前支持 .ogg / OGG Opus 输入)→ 极速版 ASR(flash recognize API)→ 返回文本结果
环境变量配置
必需配置(TTS + Feishu)
export TTS_APP_ID="your-tts-app-id"
export TTS_ACCESS_KEY="your-tts-access-key"
export FEISHU_APP_ID="your-feishu-app-id"
export FEISHU_APP_SECRET="your-feishu-app-secret"
可选配置
# ASR 语音识别(仅在需要使用 ASR 功能时配置)
export ASR_APP_ID="your-asr-app-id"
export ASR_ACCESS_KEY="your-asr-access-key"
export ASR_RESOURCE_ID="volc.bigasr.auc_turbo"默认接收者
export DEFAULT_RECEIVE_ID="ou_xxx"
注意: ASR 是可选功能,仅在调用语音识别时需要配置 ASR_APP_ID 和 ASR_ACCESS_KEY。若未显式提供 ASR_RESOURCE_ID,代码默认按本地文件极速识别场景使用 volc.bigasr.auc_turbo。
获取方式:
功能特性
context_texts 传递情绪上下文安全说明 | Security
输入限制
.ogg 音频文件(飞书语音常见为 OGG/Opus)音频输入限制 | Audio Input Constraints
执行限制
临时文件
tempfile 模块创建临时文件依赖
requests>=2.28.0
系统依赖:
安装
pip install -r requirements.txt
注意: 需要系统安装 ffmpeg
brew install ffmpegsudo apt-get install ffmpeg项目结构
feishu-voice-sender-tts/
├── SKILL.md
├── requirements.txt
└── src/
└── feishu_voice.py
更新日志
V2.0.2 (2026-03-24)
ASR_RESOURCE_ID 环境变量支持,默认适配本地文件极速识别场景