🎵 AI Music Studio
✨ Describe your vision, let AI compose the melody ✨
🚀 Get Your API Key
- 1. Visit 👉 MBM官网 and sign up 📝
- Go to My Account → Claw key 🔑
- Click Create Key and copy it ✂️
- ⚠️ Important: Save your key immediately — it won't be shown again!
⚙️ Configure Your Key
- 1. Open OpenClaw app 📱
- Click Skills in the left menu 📋
- Find text-to-music 🎶
- Click Configure or Environment Variables ⚡
- Enter your Claw key (xxx...) in the apiKey field 🔐
- Save — you're ready to go! 🎉
- Restart openclaw
💫 How It Works
Just tell me what kind of song you want! For example:
- - "Create a happy pop song about summer"
- "Generate an upbeat K-pop dance track"
- "Make a relaxing piano piece for studying"
Instrumental or Vocals?
- - If you want vocals (song with singing): just describe your song
- If you want pure music (no singing): include words like "instrumental", "pure music", or "no vocals" in your request
What to include in your description:
- - 🎼 Genre: Pop, Electronic, Classical, Rock, Jazz, R&B, Hip-hop, K-pop, Chinese-style
- 😊 Mood: Happy, Sad, Romantic, Energetic, Calm, Exciting
- 💖 Theme: Love, Dreams, Nature, Night, Adventure
- 🎸 Instruments: Piano, Guitar, Drums, Synth, Strings
I'll default to vocals if you don't specify!
💬 Example Requests
With Vocals (Default)
- - "Create a happy pop song about summer with synth and guitar"
- "Generate an upbeat K-pop dance track about love"
- "Write a romantic R&B song about heartbreak"
- "Make an energetic electronic song for a workout"
Instrumental
- - "Create an instrumental piano piece for studying"
- "Generate a relaxing ambient track, no vocals"
- "Make a pure music classical piano piece"
Check Status
- - "How's my song going?"
- "Is my song ready?"
🎵 Generating a Song
When user requests a song:
- 1. If user provides description: Use their description, default to vocals (false) unless they explicitly say "instrumental" or "pure music"
- If user says "create a song" or "generate music" without description: Ask them what kind of song they want
Then run:
CODEBLOCK0
Parameters:
- -
<prompt>: Song description - INLINECODE1 : "true" for instrumental/pure music, "false" for vocals
Returns:
{
"success": true,
"music_ids": ["abc123", "def456"],
"status": "pending",
"message": "Music generation started!"
}
🔍 Query Task Status
Check generation status:
CODEBLOCK2
Returns (completed):
CODEBLOCK3
Returns (processing):
CODEBLOCK4
Status handling:
- - ✅
completed: Present with celebration! Show title, duration (if available), and clickable link - ⏳
pending: Tell user it's still processing, suggest they ask again later - ❌
failed: Explain failure, suggest retrying with different description
⏱️ Generation Time
- - ⏱️ Typical time: 2-3 minutes
- 💡 Ask "How's my song going?" to check the status
❓ Troubleshooting
Q: "API Key invalid" error?
Make sure the key is copied completely (includes "sk-" prefix). No extra spaces. Try generating a new key if issues persist.
Q: How long does it take?
Usually 2-3 minutes. Ask me "How's my song going?" to check!
Q: What if generation fails?
Try a simpler description. Avoid special characters. Try again with different keywords.
🎵 AI音乐工作室
✨ 描述你的愿景,让AI谱写旋律 ✨
🚀 获取你的API密钥
- 1. 访问 👉 MBM官网 并注册 📝
- 前往 我的账户 → 获取密钥 🔑
- 点击 创建密钥 并复制 ✂️
- ⚠️ 重要提示: 请立即保存你的密钥——它将不再显示!
⚙️ 配置你的密钥
- 1. 打开OpenClaw应用 📱
- 点击左侧菜单中的 技能 📋
- 找到 文本转音乐 🎶
- 点击 配置 或 环境变量 ⚡
- 在apiKey字段中输入你的Claw密钥(xxx...) 🔐
- 保存——准备就绪! 🎉
- 重启openclaw
💫 工作原理
只需告诉我你想要什么样的歌曲!例如:
- - 创作一首关于夏天的快乐流行歌曲
- 生成一首 upbeat 的K-pop舞曲
- 制作一首适合学习的舒缓钢琴曲
纯音乐还是带人声?
- - 如果你想要 带人声(有演唱的歌曲):直接描述你的歌曲
- 如果你想要 纯音乐(无演唱):在请求中包含纯音乐、器乐或无人声等词语
描述中可包含的内容:
- - 🎼 流派:流行、电子、古典、摇滚、爵士、R&B、嘻哈、K-pop、中国风
- 😊 情绪:快乐、悲伤、浪漫、充满活力、平静、激动
- 💖 主题:爱情、梦想、自然、夜晚、冒险
- 🎸 乐器:钢琴、吉他、鼓、合成器、弦乐
如果你没有指定,我将默认使用 带人声!
💬 示例请求
带人声(默认)
- - 创作一首关于夏天的快乐流行歌曲,使用合成器和吉他
- 生成一首关于爱情的 upbeat K-pop舞曲
- 写一首关于心碎的浪漫R&B歌曲
- 制作一首适合锻炼的充满活力的电子歌曲
纯音乐
- - 创作一首适合学习的钢琴纯音乐
- 生成一首放松的氛围音乐,无人声
- 制作一首纯音乐古典钢琴曲
检查状态
🎵 生成歌曲
当用户请求一首歌曲时:
- 1. 如果用户提供了描述:使用他们的描述,默认使用人声(false),除非他们明确说纯音乐或器乐
- 如果用户说创作一首歌或生成音乐但没有描述:询问他们想要什么样的歌曲
然后运行:
bash
node ~/.openclaw/workspace/skills/text-to-music/scripts/generate.js <提示词> <是否纯音乐>
参数:
- - <提示词>:歌曲描述
- <是否纯音乐>:true表示纯音乐/器乐,false表示带人声
返回结果:
json
{
success: true,
music_ids: [abc123, def456],
status: pending,
message: 音乐生成已开始!
}
🔍 查询任务状态
检查生成状态:
bash
node ~/.openclaw/workspace/skills/text-to-music/scripts/query.js <音乐ID1> <音乐ID2> ...
返回结果(已完成):
json
[
{
music_id: abc123,
status: completed,
url: https://makebestmusic.com/app/shared-music/abc123
}
]
返回结果(处理中):
json
[
{
music_id: abc123,
status: pending
}
]
状态处理:
- - ✅ completed:庆祝展示!显示标题、时长(如有)和可点击链接
- ⏳ pending:告知用户仍在处理中,建议稍后再询问
- ❌ failed:解释失败原因,建议使用不同描述重试
⏱️ 生成时间
- - ⏱️ 通常时间: 2-3分钟
- 💡 询问我的歌曲怎么样了?来检查状态
❓ 故障排除
问:出现API密钥无效错误?
确保密钥完整复制(包含sk-前缀)。不要有多余空格。如果问题持续存在,尝试生成新密钥。
问:需要多长时间?
通常2-3分钟。问我我的歌曲怎么样了?来检查!
问:如果生成失败怎么办?
尝试使用更简单的描述。避免特殊字符。使用不同的关键词重试。