飞书音乐心情伴侣 — Mood Music Companion

感知用户情绪，生成治愈音乐，通过飞书消息即时送达。不是冷冰冰的点歌台，是一个懂你情绪的音乐搭档。

依赖：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          # 检查额度
mmx music generate --prompt "gentle piano, healing" --out /tmp/test_mood.mp3  # 测试生成

全部通过即可使用本 Skill。

情绪-音乐映射表

负面情绪（治愈方向）

正面情绪（助燃方向）

工作流

Step 1: 触发判断（三级触发机制）

本 Skill 采用三级触发，根据信号强度决定行为：

🟢 Level 1：显式触发（直接要歌）

用户明确要求音乐，无论是否 @机器人，立即生成。

🟡 Level 2：半隐式触发（情绪词 + @机器人）

用户表达了情绪且 @了机器人，视为求助信号，直接生成。 如果只有情绪词但没有 @，不触发（避免群聊噪音）。

🔴 Level 3：全隐式触发（极端情绪，自动送歌）

用户情绪到了极端值，无需 @，自动生成并送歌。 这些词本身就是强烈信号，沉默反而像冷漠。

负面极端（先共鸣后治愈）：

正面极端（助燃放大）：

全隐式安全规则：

• 仅在群聊中对已知用户触发（非陌生人）
• 同一用户 30 分钟内最多触发 1 次（防刷屏）
• 私聊场景下，Level 2 和 Level 3 均可无需 @ 触发

Step 2: 情绪识别

从用户消息中分析：

1. 情绪类别：匹配上方映射表（可多维度叠加）
2. 情绪强度：轻微 / 中等 / 强烈（影响音乐激烈程度和歌词策略）
3. 场景线索：工作中 / 下班后 / 深夜（影响风格选择）

Step 3: 构建 Prompt

根据情绪映射选择音乐策略，构建 prompt。

负面情绪使用"情绪曲线"策略——不直接跳到快乐，而是先共鸣再引导：

prompt 模板（负面情绪）:
\x3Cstyle>, \x3Cmood 起始: 共鸣词>, gradually shifting to \x3Cmood 目标: 治愈词>, 
\x3Cinstruments>, \x3CBPM> BPM, \x3Cvocal/instrumental>, 
a song that understands how you feel and gently lifts you up

正面情绪使用"助燃"策略——放大当前感受：

prompt 模板（正面情绪）:
\x3Cstyle>, \x3Cmood: 正面高能词>, \x3Cinstruments>, \x3CBPM> BPM, 
\x3Cvocal/instrumental>, energetic and feel-good

Step 4: 歌词策略

Step 5: 生成音乐

优先使用 CLI，回退到 Python 脚本：

# 方式一：MiniMax CLI（推荐）
# 纯音乐（负面轻微）
mmx music generate \
  --prompt "\x3Cconstructed prompt>" \
  --instrumental \
  --out /tmp/openclaw/mood_\x3Cemotion>.mp3

# 带歌词（负面强烈/正面）— 自动生成歌词
mmx music generate \
  --prompt "\x3Cconstructed prompt>" \
  --lyrics "[verse]\
[chorus]" \
  --out /tmp/openclaw/mood_\x3Cemotion>.mp3

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

Step 6: 播放与送达

生成完成后，必须完成送达，不能只输出文件路径。根据环境自动选择最佳方式。

环境探测

# 检测本地音乐播放器（macOS）
osascript -e 'id of application "Music"' 2>/dev/null && echo "HAS_MUSIC_APP"
# 或检测命令行播放器
which mpv afplay ffplay 2>/dev/null

送达策略

路径 A：本地播放器可用

# macOS 用系统命令打开默认播放器
open /tmp/openclaw/mood_\x3Cemotion>.mp3

# 或 afplay 后台播放
afplay /tmp/openclaw/mood_\x3Cemotion>.mp3 &

# 或 mpv
mpv --no-video /tmp/openclaw/mood_\x3Cemotion>.mp3 &

同时发一份到飞书群（见路径 B）。

路径 B：飞书音频消息送达

⚠️ 关键步骤，不可跳过。 飞书语音气泡需要特殊的上传+发送流程。

方式 1：使用内置脚本（推荐，一行搞定）

Skill 自带 scripts/send_feishu_audio.sh，支持 --file 模式直接发送已有音频：

# 发送已生成的音乐到飞书群（语音气泡，非文件附件）
bash scripts/send_feishu_audio.sh --file /tmp/openclaw/mood_\x3Cemotion>.mp3 "\x3Cchat_id>"

凭证自动从环境变量 FEISHU_APP_ID / FEISHU_APP_SECRET 读取， 或回退到 $HOME/.openclaw/openclaw.json。

方式 2：OpenClaw message 工具（OpenClaw 环境）

message(action="send", filePath="/tmp/openclaw/mood_\x3Cemotion>.mp3",
        message="\x3C共情文案>")

方式 3：手动 curl 两步流程（理解原理用）

# ⚠️ 关键坑：file_type 必须填 opus（不是 mp3），否则报 234001
# ⚠️ 关键坑：msg_type 必须是 audio（不是 file），否则显示为附件

# Step 1: 上传文件（file_type=opus）
FILE_KEY=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/files" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file_type=opus" \
  -F "file_name=voice.opus" \
  -F "file=@/tmp/openclaw/mood_\x3Cemotion>.mp3" \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['file_key'])")

# Step 2: 发送音频消息（msg_type=audio）
curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"receive_id\":\"$CHAT_ID\",\"msg_type\":\"audio\",\"content\":\"{\\\"file_key\\\":\\\"$FILE_KEY\\\"}\"}"

❌ 错误行为（严禁）

• 只输出文件路径如 📎 /workspace/.../output/xxx.mp3 → 用户无法访问服务器路径
• 只发文字说"已生成" → 用户听不到音乐
• 把 base64 音频贴在聊天里 → 不可读

原则：用户必须能在 2 次点击内听到音乐。

播放器优先级：open（macOS 默认）> mpv > afplay > 飞书音频消息 > 飞书文件消息

共情文案模板（简短、不说教）：

进阶：情绪追踪（可选）

如果用户频繁使用，可以在 memory/mood-music-log.json 中记录：

{
  "history": [
    {"date": "2026-04-10", "emotion": "tired", "style": "bossa nova", "rating": "👍"},
    {"date": "2026-04-09", "emotion": "anxious", "style": "ambient", "rating": null}
  ]
}

用于：

• 避免连续推荐相同风格
• 发现用户偏好（"你之前喜欢 Bossa Nova 治愈系，这次也来一首？"）
• 如果连续多天负面情绪，温和提醒（不是心理医生，只是朋友式的关心）

边界与安全

• 不是心理咨询：不诊断、不处方、不说"你应该怎样"
• 不过度解读：用户说"有点累"就是累，别上升到心理问题
• 不强制正能量：允许用户沉浸在情绪里，音乐是陪伴不是说教
• 隐私：情绪记录仅存本地，不外传

生成方式

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

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

# 纯音乐
mmx music generate --prompt "\x3Cprompt>" --instrumental --out /tmp/openclaw/mood.mp3

# 带自动歌词
mmx music generate --prompt "\x3Cprompt>" --lyrics "[verse]\
[chorus]" --out /tmp/openclaw/mood.mp3

方式二：Python 脚本（需要 API Key）

scripts/generate_mood_music.py 直接调用 MiniMax Music API：

• 读取 API Key：从环境变量 MINIMAX_API_KEY 获取
• 模型：music-2.5+
• 支持 --instrumental 切换纯音乐/带歌词
• 带歌词模式：lyrics_optimizer: true（API 自动写词）
• 输出：MP3，44100Hz，256kbps