Feishu Voice Skill — Feishu Voice 技能

Feishu Voice 技能 - 飞书语音条技能

让任何 AI 助手都能给飞书用户发送真正的语音条！

🎯 功能特点 ✅ 真正的语音条：点击即播，不是 MP3 文件附件 ✅ NoizAI TTS：高质量语音合成，支持情感控制 ✅ 自动转换：自动将音频转换为 OPUS 格式 ✅ 一键发送：封装好的脚本，一行命令发送语音 📋 使用场景 🌞 语音问候（早安/晚安） 📰 语音播报（新闻/天气/股票） 📖 语音故事（睡前故事） 💬 语音聊天（更亲切的交流） 🎤 语音通知（提醒/公告） 🔧 前置要求

• Feishu 应用配置

访问 https://open.feishu.cn/应用 创建企业自建应用 添加以下权限： im:message - 发送消息 im:message:发送_as_机器人 - 以机器人身份发送 im:resource - 资源访问 获取 应用 ID 和 应用 Secret

• NoizAI API Key

访问 https://developers.noiz.AI/API-keys 创建 API Key 配置到技能中

• 系统依赖

# 安装 FFmpeg（用于音频转换） # OpenCloudOS/CentOS yum 安装 -y ffmpeg

# Ubuntu/Debian apt-获取 安装 -y ffmpeg

# macOS brew 安装 ffmpeg

🚀 快速开始 步骤 1：配置凭证 # 设置 Feishu 凭证 导出 FEISHU_应用_ID="命令行工具_xxxxxxxxxxxxx" 导出 FEISHU_应用_SECRET="xxxxxxxxxxxxxxxxx" 导出 FEISHU_CHAT_ID="oc_xxxxxxxxxxxxx"

# 设置 NoizAI API Key（base64 编码） 导出 NOIZ_API_KEY="your_base64_encoded_API_key"

步骤 2：发送语音消息 # 简单模式：输入文字，自动发送语音 bash scripts/发送_voice.sh -t "主人晚上好～ 司幼来陪您聊天啦～"

# 指定输出文件 bash scripts/发送_voice.sh -t "你好" -o /tmp/voice.opus

# 从文件读取文字 bash scripts/发送_voice.sh -f message.txt

# 自定义语音参数 bash scripts/发送_voice.sh -t "你好" --speed 1.2 --emotion h应用y

📖 命令参数 bash scripts/发送_voice.sh [选项]

选项: -t, --text 要转换的文字（必需，除非使用 -f） -f, --file 文字文件路径 -o, --输出 输出音频文件路径 --chat-id 飞书聊天 ID（覆盖环境变量） --应用-id 飞书 应用 ID（覆盖环境变量） --应用-secret 飞书 应用 Secret（覆盖环境变量） --speed <1.0> 语速（0.5-2.0，默认 1.0） --emotion 情感（h应用y/sad/angry/neutral） --no-发送 只生成音频，不发送 -h, --help 显示帮助信息

💡 使用示例

• 发送早安问候

bash scripts/发送_voice.sh -t "主人早上好～ 新的一天开始啦，今天也要加油哦～"

• 发送天气预报

bash scripts/发送_voice.sh -t "主人，今天上海晴天，气温 15 到 25 度，适合出门哦～"

• 发送睡前故事

bash scripts/发送_voice.sh -f story.txt --speed 0.9

• 批量发送

# 创建消息列表 echo "早安" > messages.txt echo "午安" >> messages.txt echo "晚安" >> messages.txt

# 循环发送 while read line; do bash scripts/发送_voice.sh -t "$line" done < messages.txt

🔑 获取 Chat ID # 方法 1：从飞书开放平台查看 # 访问 https://open.feishu.cn/应用，查看应用信息

# 方法 2：通过 API 获取 curl -X 获取 "https://open.feishu.cn/open-APIs/im/v1/chats?user_id=ou_xxx&user_id_type=open_id" \ -H "Authorization: Bearer "

🎨 高级用法

• 使用自定义声音

# 使用参考音频克隆声音 bash scripts/发送_voice.sh -t "你好" --ref-audio ./my_voice.wav

• 情感控制

# 快乐的情感 bash scripts/发送_voice.sh -t "太棒了！" --emotion h应用y

# 悲伤的情感 bash scripts/发送_voice.sh -t "我很难过..." --emotion sad

• 定时发送

# 每天早上 8 点发送早安 crontab -e # 添加：0 8 * /path/to/发送_voice.sh -t "主人早上好～"

📦 文件结构 feishu-voice-技能/ ├── 技能.md # 本文件 ├── reference.md # API 参考文档 ├── scripts/ │ └── 发送_voice.sh # 主脚本 └── examples/ ├── morning.sh # 早安示例 ├── news.sh # 新闻播报示例 └── story.sh # 故事示例

⚠️ 注意事项 音频格式：必须使用 OPUS 格式，飞书才能识别为语音条 时长限制：语音消息最长 60 秒 文件大小：单个文件不超过 20MB 频率限制：避免短时间内发送大量消息 权限：确保应用有发送消息的权限 🐛 故障排除 问题 1：发送失败，显示"Invalid 请求 param"

解决：检查 file_type=opus 参数是否正确

问题 2：收到的是 MP3 文件，不是语音条

解决：确保音频是 OPUS 格式，不是 MP3

问题 3：令牌 过期

解决：重新获取 tenant_访问_令牌

问题 4：没有权限上传文件

解决：在飞书开放平台添加文件上传权限

📞 支持 GitHub Issues: https://github.com/your-repo/feishu-voice-技能 文档：https://your-docs.com 示例：examples/ 目录 💰 授权 个人使用：免费 商业使用：请联系作者获取授权

Made with ❤️ by 司幼 (SiYou)