🎵 AI 音乐工作室

✨ 描述你的音乐构想，让 AI 为你谱写旋律 ✨

🚀 获取你的 API 密钥

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

⚙️ 配置你的密钥

1. 打开 OpenClaw 应用 📱
2. 点击左侧菜单中的 Skills 📋
3. 找到 text-to-music 🎶
4. 点击 Configure 或 Environment Variables ⚡
5. 在 apiKey 字段中输入你的 Claw key（格式如：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. 若用户提供了完整描述：使用其描述作为 prompt；默认生成带人声版本（instrumental = false），除非用户明确提及 “instrumental” 或 “pure music”
2. 若用户仅说 “create a song” 或 “generate music”，但未提供具体描述：需向用户进一步询问希望生成何种风格的歌曲

随后执行以下命令：

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

参数说明：

• ：歌曲描述文本
• ：设为 "true" 表示纯音乐/无人声；设为 "false" 表示带人声

返回结果示例：

{
  "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：如果生成失败怎么办？

建议尝试更简洁的描述；避免使用特殊字符；也可更换关键词后再次尝试。