飞书 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 login

4. 验证

# 检查登录状态
mmx auth status

# 检查剩余额度
mmx quota

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

全部通过即可使用本 Skill。

场景预设表

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

工作流

Step 1: 解析用户意图

从用户消息中提取：

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

Step 2: 构建 Prompt 并生成

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

# 方式一：MiniMax CLI（推荐）
mmx music generate \
  --prompt "\x3Cconstructed prompt>" \
  --instrumental \
  --out /tmp/openclaw/bgm_\x3Cscene>.mp3

# 方式二：Python 脚本（需要 MINIMAX_API_KEY 环境变量）
python3 scripts/generate_bgm.py \
  --prompt "\x3Cconstructed prompt>" \
  --output /tmp/openclaw/bgm_\x3Cscene>.mp3

Prompt 构建规则：

\x3Cstyle>, instrumental, \x3Cmood keywords>, \x3Cinstrument hints>, \x3CBPM> BPM, 
background music for \x3Cscene 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 mix

Step 3: 发送到飞书

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

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

Step 4: 响应格式

发送后回复：

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

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

快捷指令

生成方式

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

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

mmx music generate \
  --prompt "\x3Cprompt>" \
  --instrumental \
  --out /tmp/openclaw/bgm_\x3Cscene>.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 秒

错误处理

注意事项

• 只生成纯音乐（instrumental），避免人声歌曲作为 BGM
• 默认不加水印（aigc_watermark: false）
• 单次生成约 2 分钟音频，适合单曲循环
• 生成耗时约 60-120 秒，需提前告知用户等待