MiniMax Music Generation OpenClaw Skill
Generate AI music using MiniMax Music 2.5 API. Use when the user wants to: (1) generate instrumental/pure music, (2) generate songs with lyrics, (3) generate...
Installation
clawhub install minimax-music
Requires npm i -g clawhub
53
Downloads
1
Stars
0
current installs
0 all-time
1
Versions
Power your OpenClaw skills with
the best open-source models.
Drop-in OpenAI-compatible API. No data leaves Europe.
Explore Inference APIGLM
GLM 5
$1.00 / $3.20
per M tokens
Kimi
Kimi K2.5
$0.60 / $2.80
per M tokens
MiniMax
MiniMax M2.5
$0.30 / $1.20
per M tokens
Qwen
Qwen3.5 122B
$0.40 / $3.00
per M tokens
MiniMax Music Generation
Generate AI music using MiniMax Music 2.5 API.
Prerequisites
Set the MINIMAX_API_KEY environment variable:
export MINIMAX_API_KEY="your-api-key-here"
Quick Start
# Generate instrumental music
python3 ~/.openclaw/workspace/skills/minimax-music/scripts/minimax_music.py create \
--prompt "Piano, Relaxing, Meditative" \
--instrumental \
--download ~/Music
# Generate song with lyrics
python3 ~/.openclaw/workspace/skills/minimax-music/scripts/minimax_music.py create \
--prompt "Pop, Upbeat, Celebratory" \
--lyrics "[Verse]\n阳光洒满大地\n[Chorus]\n快乐每一天" \
--download ~/Music
# Generate lyrics first
python3 ~/.openclaw/workspace/skills/minimax-music/scripts/minimax_music.py lyrics \
--prompt "一首关于春天的歌" \
--output lyrics.txt
Music Generation Parameters
| Parameter | Description | Default |
|---|---|---|
--prompt |
Music style description (required) | - |
--lyrics |
Lyrics text with [Verse], [Chorus] markers | - |
--lyrics-file |
Path to lyrics file | - |
--instrumental |
Generate instrumental music (no vocals) | false |
--sample-rate |
Audio quality: 44100, 48000 | 44100 |
--bitrate |
Audio bitrate: 128000, 256000, 320000 | 256000 |
--format |
Output format: mp3, wav, flac | mp3 |
--download |
Directory to save audio file | - |
--model |
Model ID | music-2.5 |
Prompt Examples
Instrumental Music
# Relaxing piano
--prompt "Piano, Relaxing, Meditative, Soft, Ambient"
# Electronic ambient
--prompt "Electronic, Ambient, Atmospheric, Synthesizer, Chill"
# Orchestral
--prompt "Orchestra, Cinematic, Epic, Strings, Brass"
# Jazz
--prompt "Jazz, Smooth, Saxophone, Piano, Night Club"
Songs with Lyrics
# Chinese pop
--prompt "Mandopop, Emotional, Ballad" \
--lyrics "[Verse]\n夜深人静\n思念着你\n[Chorus]\n心中的爱\n永不改变"
# English pop
--prompt "Pop, Upbeat, Energetic" \
--lyrics "[Verse]\nWalking down the street\nFeeling the beat\n[Chorus]\nLet's celebrate tonight"
Lyrics Format
Use section markers to structure the song:
[Intro]
(Instrumental opening)
[Verse]
Main lyrics here
[Pre-Chorus]
Build-up section
[Chorus]
Main hook/refrain
[Bridge]
Contrast section
[Outro]
Ending section
Daily Quota
MiniMax Token Plan subscriptions include:
- music-2.5: 7 generations/day (Plan 199)
- Quota resets daily at midnight
Sending Audio via Feishu
After generating music, send to user's Feishu:
import requests
# 1. Upload audio file
with open("music.mp3", "rb") as f:
upload_resp = requests.post(
"https://open.feishu.cn/open-apis/im/v1/files",
headers={"Authorization": f"Bearer {TENANT_ACCESS_TOKEN}"},
files={"file": ("music.mp3", f, "audio/mpeg")},
data={"file_type": "stream", "file_name": "music.mp3"}
)
file_key = upload_resp.json()["data"]["file_key"]
# 2. Send file message
requests.post(
"https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
headers={"Authorization": f"Bearer {TENANT_ACCESS_TOKEN}", "Content-Type": "application/json"},
json={
"msg_type": "file",
"content": json.dumps({"file_key": file_key}),
"receive_id": USER_OPEN_ID
}
)
Rules
- Always check
MINIMAX_API_KEYis set before API calls. - Use
--instrumentalfor pure music without vocals. - Default to 44100 Hz, 256 kbps, MP3 format for good quality and compatibility.
- Download immediately - audio URLs expire after some time.
- Respect daily quota - inform user if they've hit their limit.
- Provide audio file to user after generation (download + share via Feishu if applicable).
Statistics
Author
REXDONG1
@rexdong1
Latest Changes
v1.0.0 · Apr 7, 2026
Initial release: AI music generation with MiniMax Music 2.5 API. Supports instrumental music, songs with lyrics, and lyrics-only generation.
Quick Install
clawhub install minimax-music Related Skills
Other popular skills you might find useful.
Chat with 100+ AI Models in one App.
Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.