🎵 AI 音乐工作室

✨ 描述你的创意构想，让 AI 为你谱写旋律 ✨

🚀 获取你的 API 密钥

1. 访问 👉 MBM官网 并注册 📝
2. 进入 My Account → Claw key 🔑
3. 点击 Create Key，然后复制密钥 ✂️
4. ⚠️ 重要提示：请立即保存你的密钥——该密钥仅显示一次，之后不可再次查看！

⚙️ 配置你的密钥

1. 打开 OpenClaw 应用 📱
2. 点击左侧菜单中的 Skills 📋
3. 找到 text-to-music 🎶
4. 点击 Configure 或 Environment Variables ⚡
5. 在 apiKey 字段中输入你的 Claw 密钥（格式如：xxx...）🔐
6. 保存配置 —— 你已准备就绪！🎉
7. 重启 openclaw

💫 工作原理

只需告诉我你想要什么样的歌曲！例如：

• “创作一首关于夏天的欢快流行歌曲”
• “生成一首节奏明快的 K-pop 舞曲”
• “制作一首适合学习的舒缓钢琴曲”

纯音乐还是带人声？

• 如果你希望包含 人声（即带演唱的歌曲）：直接描述你的歌曲即可
• 如果你希望生成 纯音乐（无人声）：请在请求中明确包含 “instrumental”、“pure music” 或 “no vocals” 等关键词

描述中建议包含以下要素：

• 🎼 曲风：Pop、Electronic、Classical、Rock、Jazz、R&B、Hip-hop、K-pop、Chinese-style
• 😊 情绪：Happy、Sad、Romantic、Energetic、Calm、Exciting
• 💖 主题：Love、Dreams、Nature、Night、Adventure
• 🎸 乐器：Piano、Guitar、Drums、Synth、Strings

若未特别说明，系统将默认生成 带人声 的版本！

💬 示例请求

带人声（默认行为）

• “创作一首以合成器与吉他为主的、关于夏天的欢快流行歌曲”
• “生成一首关于爱情的节奏明快的 K-pop 舞曲”
• “写一首关于心碎的浪漫 R&B 歌曲”
• “制作一首适合健身的充满能量的电子音乐”

纯音乐

• “创作一首适合学习的纯钢琴曲”
• “生成一首舒缓的氛围音乐，无人声”
• “制作一首纯音乐风格的古典钢琴曲”

查询状态

• “我的歌曲进展如何？”
• “我的歌曲完成了吗？”

🎵 歌曲生成流程

当用户发起歌曲生成请求时：

1. 若用户提供完整描述：使用其描述作为输入；默认生成带人声版本（instrumental = false），除非用户明确提及 “instrumental” 或 “pure music”
2. 若用户仅说 “create a song” 或 “generate music”，但未提供具体描述：向用户询问其期望的歌曲类型

随后执行以下命令：

node ~/.openclaw/workspace/skills/text-to-music/scripts/generate.js "" 

参数说明：

• ：歌曲描述文本
• ：若为纯音乐/无人声，填 "true"；若为人声歌曲，填 "false"

返回示例（JSON）：

{
 "success": true,
 "music_ids": ["abc123", "def456"],
 "status": "pending",
 "message": "Music generation started!"
}

🔍 查询任务状态

检查生成进度：

node ~/.openclaw/workspace/skills/text-to-music/scripts/query.js "  ..."

返回示例（已完成）：

[
 {
 "music_id": "abc123",
 "status": "completed",
 "url": "https://makebestmusic.com/app/shared-music/abc123"
 }
]

返回示例（处理中）：

[
 {
 "music_id": "abc123",
 "status": "pending"
 }
]

状态处理逻辑：

• ✅ completed：以庆祝方式呈现结果！展示标题（如有）、时长（如可获取）及可点击的播放链接
• ⏳ pending：告知用户仍在处理中，并建议稍后再次查询
• ❌ failed：说明失败原因，并建议更换更简洁的描述后重试

⏱️ 生成耗时

• ⏱️ 典型耗时：2–3 分钟
• 💡 可随时提问 “How’s my song going?” 来查询当前状态

❓ 常见问题排查

Q：出现 “API Key invalid” 错误？

请确认密钥已完整复制（必须包含 sk- 前缀），且无额外空格。若问题持续存在，建议重新生成一个新密钥。

Q：生成需要多长时间？

通常需 2–3 分钟。你可以随时问我 “How’s my song going?” 来查询进度！

Q：如果生成失败怎么办？

尝试使用更简洁的描述；避免使用特殊字符；换用不同关键词再次尝试。