- name
- feishu-bgm
- description
- >
飞书 BGM — 场景化背景音乐生成器
根据工作场景生成纯音乐 BGM，通过飞书音频消息即时送达群聊。
依赖：MiniMax CLI（mmx-cli）+ Token Plan
快速配置（首次使用）
1. 安装 MiniMax CLI
npm install -g mmx-cli需要 Node.js 18+。完整文档：https://github.com/MiniMax-AI/cli
2. 订阅 Token Plan
前往 MiniMax 平台订阅 Token Plan（音乐生成需要额度）：
- 🇨🇳 国内：https://platform.minimaxi.com/subscribe/token-plan
- 🌍 海外：https://platform.minimax.io/subscribe/token-plan
3. 登录认证
# 方式一：API Key 登录（推荐，从平台「接口密钥」页获取）
mmx auth login --api-key sk-xxxxx
# 方式二：浏览器 OAuth 登录
mmx auth login4. 验证
# 检查登录状态
mmx auth status
# 检查剩余额度
mmx quota
# 测试生成一首 BGM
mmx music generate --prompt "calm piano, ambient" --instrumental --out /tmp/test_bgm.mp3全部通过即可使用本 Skill。
场景预设表
用户描述模糊时，从预设匹配最近场景；描述具体时，直接用用户描述构建 prompt。
| 场景关键词 | 风格 | BPM | 情绪关键词 |
|---|---|---|---|
| 开会/会议/讨论 | Ambient, Minimal | 70-90 | calm, professional, subtle |
| 头脑风暴/创意 | Electronic, IDM | 100-120 | creative, energetic, playful |
| 加班/赶工/冲刺 | Lo-fi, Chillhop | 85-95 | focused, determined, warm |
| 放松/休息/午休 | Bossa Nova, Jazz | 90-110 | relaxed, smooth, cozy café |
| 庆祝/发布/上线 | Funk, Disco | 115-125 | celebratory, groovy, uplifting |
| 复盘/总结/回顾 | Piano, Classical | 60-80 | reflective, thoughtful, gentle |
| 面试/1on1 | Acoustic, Folk | 80-100 | warm, comfortable, welcoming |
| 站会/日会 | Pop, Indie | 110-120 | light, breezy, efficient |
工作流
Step 1: 解析用户意图
从用户消息中提取：
- 场景：匹配上表或自由描述
- 时长偏好：默认不指定（API 生成约 2 分钟）
- 特殊要求：如"不要鼓点"、"要有钢琴"
Step 2: 构建 Prompt 并生成
优先使用 CLI（无需管理 API Key），回退到 Python 脚本：
# 方式一：MiniMax CLI（推荐）
mmx music generate \
--prompt "<constructed prompt>" \
--instrumental \
--out /tmp/openclaw/bgm_<scene>.mp3
# 方式二：Python 脚本（需要 MINIMAX_API_KEY 环境变量）
python3 scripts/generate_bgm.py \
--prompt "<constructed prompt>" \
--output /tmp/openclaw/bgm_<scene>.mp3Prompt 构建规则：
<style>, instrumental, <mood keywords>, <instrument hints>, <BPM> BPM,
background music for <scene description>, no vocals, professional and clean mix示例：
Ambient, Minimal, instrumental, calm, professional, subtle,
soft piano, warm pads, gentle strings, 80 BPM,
background music for a team meeting, no vocals, professional and clean mixStep 3: 发送到飞书
生成完成后，使用 message 工具发送音频文件到当前群聊：
message(action="send", filePath="/tmp/openclaw/bgm_<scene>.mp3",
message="🎵 <场景名> BGM 已就绪")Step 4: 响应格式
发送后回复：
🎵 BGM 已送达！
场景：<场景描述>
风格：<风格>
适合：<使用建议>
💡 不满意可以说「换一首」或描述你想要的风格快捷指令
| 用户说 | 动作 |
|---|---|
| "换一首" / "再来一首" | 同场景重新生成 |
| "要欢快一点的" | 调整情绪关键词重新生成 |
| "不要鼓" / "加点吉他" | 修改乐器提示重新生成 |
| "停" / "够了" | 结束，不再生成 |
生成方式
方式一：MiniMax CLI（推荐，零代码）
CLI 自动管理认证和 region，无需手动传 API Key：
mmx music generate \
--prompt "<prompt>" \
--instrumental \
--out /tmp/openclaw/bgm_<scene>.mp3方式二：Python 脚本（需要 API Key）
scripts/generate_bgm.py 直接调用 MiniMax Music API：
- 读取 API Key：从环境变量
MINIMAX_API_KEY获取 - 模型：
music-2.5+ - 固定参数：
is_instrumental: true，output_format: url - 音频设置：44100 Hz，256kbps，MP3
- 超时：300 秒
错误处理
| 错误 | 处理 |
|---|---|
| API 超时 | 告知用户生成较慢，自动重试一次 |
| 生成失败 | 提示用户换个描述试试 |
| 余额不足 | 告知用户 API 额度用完 |
注意事项
- 只生成纯音乐（instrumental），避免人声歌曲作为 BGM
- 默认不加水印（
aigc_watermark: false） - 单次生成约 2 分钟音频，适合单曲循环
- 生成耗时约 60-120 秒，需提前告知用户等待