Best use case
Voice Reply Skill - 语音回复技能 is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
> 🤖 支持平台：飞书（Feishu）
Teams using Voice Reply Skill - 语音回复技能 should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/minimax-voicereponse-feishu/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How Voice Reply Skill - 语音回复技能 Compares
| Feature / Agent | Voice Reply Skill - 语音回复技能 | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
> 🤖 支持平台：飞书（Feishu）
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# Voice Reply Skill - 语音回复技能
> 🤖 支持平台：飞书（Feishu）
>
> 将文字转换为语音气泡，通过飞书发送
---
## ⚠️ 首次使用必读
**使用前必须配置 MiniMax API Key**，否则无法运行！
配置方式：
1. 获取 Key：https://www.minimaxi.com/
2. 设置环境变量：`export MINIMAX_VOICE_API_KEY="your-key"`
或创建配置文件：`cp config.example.txt config.txt` 并填入 Key
3. 验证：`python3 scripts/voice_reply.py "测试"`
详见下方「首次使用配置」章节。
---
## 功能
当检测到用户请求语音回复时，自动：
1. 获取要转换的文字
2. 调用 MiniMax TTS API 生成语音
3. 转换为 OGG 格式（飞书语音气泡格式）
4. 通过飞书发送语音消息
## 触发方式
用户发送以下任一方式都会触发：
- `语音回复：xxx` 或 `语音回复 xxx`
- `/voice xxx`
- 直接说"说给我听"
- 说"语音回复"
---
## 首次使用配置
### 1. 获取 MiniMax API Key
1. 注册 MiniMax 开放平台：https://www.minimaxi.com/
2. 在控制台创建项目，获取 API Key
3. 设置环境变量（推荐）：
```bash
export MINIMAX_VOICE_API_KEY="your-api-key-here"
```
### 2. 配置文件方式（可选）
如果不想设置环境变量，可以创建配置文件：
```bash
cp config.example.txt config.txt
# 编辑 config.txt，填入你的 API Key
```
### 3. 验证
```bash
python3 scripts/voice_reply.py "你好，测试一下"
```
成功后会在终端打印：`/path/to/output.ogg`
---
## 技术细节
### 流程
```
文字 → MiniMax TTS (MP3) → FFmpeg转OGG → 飞书语音气泡
```
### 音频格式
- TTS 输出：MP3 (32kHz)
- 飞书语音气泡：OGG (Opus codec)
- 转换后采样率：48000Hz
- 比特率：128kbps
### 依赖
- Python 3.8+
- `requests` 库：`pip install requests`
- `ffmpeg`（系统命令）
- MiniMax TTS API Key
### 可用音色
| voice_id | 说明 |
|----------|------|
| male-qn-qingse | 男性青涩音色（默认） |
| female-qn-qingse | 女性青涩音色 |
| male-qn-jingqi | 男性京片子 |
| female-qn-tianmei | 女性甜妹 |
| ... | 更多音色见 MiniMax 文档 |
修改方法：编辑 `scripts/voice_reply.py`，找到 `voice_id` 字段
---
## 文件结构
```
minimax_ttsresponse_feishu/
├── SKILL.md # 本文件
├── config.example.txt # 配置示例
├── scripts/ # 脚本目录
│ └── voice_reply.py # 主脚本
└── references/ # 参考文档
└── README.md # 详细说明
```
---
## 常见问题
### Q: 提示"网络请求失败"
A: 检查 API Key 是否正确配置，网络是否畅通
### Q: 提示"API返回错误"
A: 检查 API Key 是否有 TTS 权限，或额度是否充足
### Q: 飞书收不到语音
A: 确认是飞书平台，微信不支持原生语音气泡
### Q: 想换音色
A: 编辑 `scripts/voice_reply.py`，修改 `voice_id` 参数
---
## 贡献
欢迎提交 Issue 和 PR！Related Skills
Invoice Generator
Creates professional invoices in markdown and HTML
brand-voice-generator
Creates consistent brand voice guidelines and content. Generates copy that matches your brand personality across all channels. Perfect for startups building their identity.
invoice-ocr
发票 OCR 识别技能。扫描文件夹中的发票文件（PDF/图片），调用阿里云 OCR API 识别发票信息并导出到 Excel 表格。支持 17+ 种发票类型（增值税发票、火车票、出租车票、机票行程单、定额发票、机动车销售发票、过路过桥费发票等）。使用场景：(1) 用户提到"发票识别"、"发票统计"、"发票整理"、"发票汇总" (2) 用户需要批量处理发票 (3) 用户提到阿里云 OCR 识别发票。**重要：首次使用必须先配置阿里云凭证，主动向用户索要 AccessKey ID 和 AccessKey Secret，或引导用户运行 --config 命令自行配置。**
Bland AI — Voice Calling Skill
Make and manage AI-powered phone calls via the Bland AI API.
afrexai-invoice-engine
Generate, manage, and track professional invoices with payment terms, recurring billing, overdue automation, and financial reporting. Use when creating invoices, tracking payments, managing clients, or reviewing revenue.
feishu-voice-send
飞书语音消息发送：使用官方 API 上传 OPUS 音频并发送语音消息，解决 OpenClaw 内置发送缺少 duration 参数的问题。| Send voice messages via Feishu official API, fixing OpenClaw's missing duration parameter bug.
voice-clone
声音复刻技能，使用 AI Artist API 进行音色克隆和语音合成。支持查询已有音色、上传音频创建新音色、使用指定音色合成语音。 ⚠️ 使用前必须设置环境变量 AI_ARTIST_TOKEN 为你的 API Key！ 获取 API Key：访问 https://staging.kocgo.vip/index 注册登录后创建。 触发场景： - 用户要求生成语音，如"用蔡总的音色说..."、"生成一段语音"、"语音合成"等。 - 用户要求克隆音色，如"上传音频创建音色"、"复刻这个声音"、"创建我的音色"等。 - 用户查询已有音色，如"有哪些音色"、"列出音色"、"查看音色列表"等。 - 用户指定音色名称或 ID 进行语音合成。 - 用户发送语音消息后要求用该声音合成其他内容。
voice-tts
语音输入（Whisper ASR）+ 语音输出（Edge TTS）技能，支持 agent 专属音色，可调用 send_voice_reply.mjs 发送 Telegram 语音消息。
amber-voice-assistant
AI phone assistant and virtual receptionist for OpenClaw. Answers inbound phone calls, screens callers, makes outbound phone calls, and books appointments — all over Twilio + OpenAI Realtime voice. Full telephone workflow: phone call screening, live call transcripts, CRM contact memory, calendar integration. Ideal for anyone who wants an AI to answer their phone, handle call screening, or make phone calls autonomously. Includes interactive setup wizard, live call dashboard, and human-in-the-loop escalation. Also ships as a Claude Desktop MCP plugin — dial phone numbers, check call history, query CRM, and manage calendar directly from Claude Desktop.
Skill: Gmail Auto-Reply for Client
## Purpose
discord-voice
Real-time voice conversations in Discord voice channels with Claude AI
gitcode-issue-reply
Generate reply drafts for a single GitCode issue with similar-issue references; maintainer reviews before posting. Use when user asks to reply to or comment on an issue and provides a GitCode issue link; do not use when user only wants to fetch or query issue data. 针对单个 GitCode Issue 生成回复草稿（含相似 Issue 参考），维护者审阅后可发送评论；仅当用户要回复或评论且提供链接时使用，仅获取或查询 issue 信息时勿用。Python 3.7+ standard library only.