Feishu Voice Skill - 飞书语音条技能

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

🎯 功能特点

• - ✅ 真正的语音条：点击即播，不是 MP3 文件附件
• ✅ NoizAI TTS：高质量语音合成，支持情感控制
• ✅ 自动转换：自动将音频转换为 OPUS 格式
• ✅ 一键发送：封装好的脚本，一行命令发送语音

📋 使用场景

• - 🌞 语音问候（早安/晚安）
• 📰 语音播报（新闻/天气/股票）
• 📖 语音故事（睡前故事）
• 💬 语音聊天（更亲切的交流）
• 🎤 语音通知（提醒/公告）

🔧 前置要求

1. Feishu 应用配置

1. 1. 访问 https://open.feishu.cn/app
2. 创建企业自建应用
3. 添加以下权限：

- im:message - 发送消息 - im:message:sendasbot - 以机器人身份发送 - im:resource - 资源访问

1. 4. 获取 App ID 和 App Secret

2. NoizAI API Key

1. 1. 访问 https://developers.noiz.ai/api-keys
2. 创建 API Key
3. 配置到技能中

3. 系统依赖

bash

安装 FFmpeg（用于音频转换）

OpenCloudOS/CentOS

yum install -y ffmpeg

Ubuntu/Debian

apt-get install -y ffmpeg

macOS

brew install ffmpeg

🚀 快速开始

步骤 1：配置凭证

bash

设置 Feishu 凭证

export FEISHUAPPID=cli_xxxxxxxxxxxxx
export FEISHUAPPSECRET=xxxxxxxxxxxxxxxxx
export FEISHUCHATID=oc_xxxxxxxxxxxxx

设置 NoizAI API Key（base64 编码）

export NOIZAPIKEY=yourbase64encodedapikey

步骤 2：发送语音消息

bash

简单模式：输入文字，自动发送语音

bash scripts/send_voice.sh -t 主人晚上好～ 司幼来陪您聊天啦～

指定输出文件

bash scripts/send_voice.sh -t 你好 -o /tmp/voice.opus

从文件读取文字

bash scripts/send_voice.sh -f message.txt

自定义语音参数

bash scripts/send_voice.sh -t 你好 --speed 1.2 --emotion happy

📖 命令参数

bash
bash scripts/send_voice.sh [选项]

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

💡 使用示例

1. 发送早安问候

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

2. 发送天气预报

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

3. 发送睡前故事

bash
bash scripts/send_voice.sh -f story.txt --speed 0.9

4. 批量发送

bash

创建消息列表

echo 早安 > messages.txt
echo 午安 >> messages.txt
echo 晚安 >> messages.txt

循环发送

while read line; do bash scripts/send_voice.sh -t $line done < messages.txt

🔑 获取 Chat ID

bash

方法 1：从飞书开放平台查看

访问 https://open.feishu.cn/app，查看应用信息

方法 2：通过 API 获取

curl -X GET https://open.feishu.cn/open-apis/im/v1/chats?userid=ouxxx&useridtype=open_id \ -H Authorization: Bearer accesstoken>

🎨 高级用法

1. 使用自定义声音

bash

使用参考音频克隆声音

bash scripts/sendvoice.sh -t 你好 --ref-audio ./myvoice.wav

2. 情感控制

bash

快乐的情感

bash scripts/send_voice.sh -t 太棒了！ --emotion happy

悲伤的情感

bash scripts/send_voice.sh -t 我很难过... --emotion sad

3. 定时发送

bash

每天早上 8 点发送早安

crontab -e

添加：0 8 * /path/to/send_voice.sh -t 主人早上好～

📦 文件结构

feishu-voice-skill/
├── SKILL.md # 本文件
├── reference.md # API 参考文档
├── scripts/
│ └── send_voice.sh # 主脚本
└── examples/
├── morning.sh # 早安示例
├── news.sh # 新闻播报示例
└── story.sh # 故事示例

⚠️ 注意事项

1. 1. 音频格式：必须使用 OPUS 格式，飞书才能识别为语音条
2. 时长限制：语音消息最长 60 秒
3. 文件大小：单个文件不超过 20MB
4. 频率限制：避免短时间内发送大量消息
5. 权限：确保应用有发送消息的权限

🐛 故障排除

问题 1：发送失败，显示Invalid request param

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

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

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

问题 3：Token 过期

解决：重新获取 tenantaccesstoken

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

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

📞 支持

• - GitHub Issues: https://github.com/your-repo/feishu-voice-skill
• 文档：https://your-docs.com
• 示例：examples/ 目录

💰 授权

• - 个人使用：免费
• 商业使用：请联系作者获取授权

---

Made with ❤️ by 司幼 (SiYou)