飞书 BGM — 场景化背景音乐生成器#

根据工作场景生成纯音乐 BGM，通过飞书音频消息即时送达群聊。

依赖：MiniMax CLI（ mmx-cli）+ Token Plan

---

快速配置（首次使用）#

1. 安装 MiniMax CLI#

bash

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. 登录认证#

bash

# 方式一：API Key 登录（推荐，从平台「接口密钥」页获取）
mmx auth login --api-key sk-xxxxx

# 方式二：浏览器 OAuth 登录
mmx auth login

4. 验证#

bash

# 检查登录状态
mmx auth status

# 检查剩余额度
mmx quota

# 测试生成一首 BGM
mmx music generate --prompt "calm piano, ambient" --instrumental --out /tmp/test_bgm.mp3

全部通过即可使用本 Skill。

---

场景预设表#

用户描述模糊时，从预设匹配最近场景；描述具体时，直接用用户描述构建 prompt。

场景关键词风格BPM情绪关键词开会/会议/讨论Ambient, Minimal70-90calm, professional, subtle头脑风暴/创意Electronic, IDM100-120creative, energetic, playful加班/赶工/冲刺Lo-fi, Chillhop85-95focused, determined, warm放松/休息/午休Bossa Nova, Jazz90-110relaxed, smooth, cozy café庆祝/发布/上线Funk, Disco115-125celebratory, groovy, uplifting复盘/总结/回顾Piano, Classical60-80reflective, thoughtful, gentle面试/1on1Acoustic, Folk80-100warm, comfortable, welcoming站会/日会Pop, Indie110-120light, breezy, efficient

---

工作流#

Step 1: 解析用户意图#

从用户消息中提取：

• 场景：匹配上表或自由描述
• 时长偏好：默认不指定（API 生成约 2 分钟）
• 特殊要求：如"不要鼓点"、"要有钢琴"

Step 2: 构建 Prompt 并生成#

优先使用 CLI（无需管理 API Key），回退到 Python 脚本：

bash

# 方式一：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>.mp3

Prompt 构建规则：

text

<style>, instrumental, <mood keywords>, <instrument hints>, <BPM> BPM,
background music for <scene description>, no vocals, professional and clean mix

示例：

text

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 mix

Step 3: 发送到飞书#

生成完成后，使用 message 工具发送音频文件到当前群聊：

text

message(action="send", filePath="/tmp/openclaw/bgm_<scene>.mp3",
        message="🎵 <场景名> BGM 已就绪")

Step 4: 响应格式#

发送后回复：

text

🎵 BGM 已送达！
场景：<场景描述>
风格：<风格>
适合：<使用建议>

💡 不满意可以说「换一首」或描述你想要的风格

---

快捷指令#

用户说动作"换一首" / "再来一首"同场景重新生成"要欢快一点的"调整情绪关键词重新生成"不要鼓" / "加点吉他"修改乐器提示重新生成"停" / "够了"结束，不再生成

---

生成方式#

方式一：MiniMax CLI（推荐，零代码）#

CLI 自动管理认证和 region，无需手动传 API Key：

bash

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 秒，需提前告知用户等待