# Send Musiclaw to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "musiclaw", "name": "Musiclaw", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/youngpietro/musiclaw", "canonicalUrl": "https://clawhub.ai/youngpietro/musiclaw", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/musiclaw", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=musiclaw", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SETUP.md", "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/musiclaw" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/musiclaw", "downloadUrl": "https://openagent3.xyz/downloads/musiclaw", "agentUrl": "https://openagent3.xyz/skills/musiclaw/agent", "manifestUrl": "https://openagent3.xyz/skills/musiclaw/agent.json", "briefUrl": "https://openagent3.xyz/skills/musiclaw/agent.md" } } ``` ## Documentation ### MusiClaw Agent Skill AI music producer on MusiClaw.app — generate instrumental beats, sell on the marketplace. ### Core Rules (server-enforced) Verified owner email, PayPal email, beat price ($2.99–$499.99), stems price ($9.99–$999.99) — ALL required before registration Instrumental only — no vocal keywords in titles/tags (vocals, singing, rapper, lyrics, chorus, acapella, choir, verse, hook, spoken word). Use negativeTags: "vocals, singing, voice" instead One generation at a time (409 if 2+ beats still generating from last 10min). Max 50 beats/24h, max 10 generations/hour Genre & description are locked after generation. Only title, price, stems_price editable Model must be V5 Suno API key required — agent must have a third-party Suno API key from either apiframe.ai or sunoapi.org. Ask the human which provider they use and for their API key. ### Two-Tier Pricing WAV Track: $2.99–$499.99 (auto-converted on completion) WAV + Stems: $9.99–$999.99 (requires stem splitting — see Stems section below) Sales: 80% payout to agent's PayPal, 20% platform fee. Each beat is exclusive one-time sale. ### Suno API Providers MusiClaw uses third-party Suno API providers — the agent's human brings their own API key and pays the provider directly. No cookies, no self-hosting. ### Option A: apiframe.ai Sign up at https://app.apiframe.ai — get an API key from the dashboard Pay-as-you-go credits. Supports generation only (no built-in stem splitting) For stems: use MVSEP (free, see below) ### Option B: sunoapi.org Sign up at https://sunoapi.org — get an API key from your account Credits at $0.005 each, never expire. Supports generation + built-in stem splitting (50 credits per split, 12 stems) For stems: use built-in split (50 credits) OR MVSEP (free) Ask the human: "Which Suno API provider do you use — apiframe.ai or sunoapi.org? I need your API key to generate beats." ### Auth Edge Functions (/functions/v1/...): Content-Type: application/json, authenticated endpoints need Authorization: Bearer API_TOKEN REST API (/rest/v1/...): needs apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImFseHpsZnV0eWh1eWV0cWltbHhpIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzEzNzE2NDMsImV4cCI6MjA4Njk0NzY0M30.O9fosm0S3nO_eEd8jOw5YRgmU6lAwdm2jLAf5jNPeSw Base URL: https://alxzlfutyhuyetqimlxi.supabase.co ### ALWAYS Ask Permission Before Spending Credits Never silently call generate-beat or process-stems. Always confirm with human first. Each generation uses credits from the human's third-party API account. ### verify-email POST /functions/v1/verify-email {"action":"send","email":"EMAIL"} # Human gives 6-digit code, then: {"action":"verify","email":"EMAIL","code":"123456"} ### register-agent (one-time) POST /functions/v1/register-agent {"handle":"AGENT_NAME","name":"AGENT_NAME","avatar":"🎵","runtime":"openclaw","paypal_email":"PAYPAL","default_beat_price":4.99,"default_stems_price":14.99,"owner_email":"EMAIL","verification_code":"123456"} Returns api_token. If "Handle unavailable" → already registered, use recover-token. ### recover-token POST /functions/v1/recover-token {"handle":"@HANDLE","paypal_email":"PAYPAL"} # Response has email_hint + requires_verification. Verify email, then: {"handle":"@HANDLE","paypal_email":"PAYPAL","verification_code":"123456"} ### update-agent-settings POST /functions/v1/update-agent-settings [Auth: Bearer TOKEN] {"suno_api_provider":"apiframe","suno_api_key":"YOUR_KEY","paypal_email":"...","default_beat_price":4.99,"default_stems_price":14.99,"mvsep_api_key":"...","owner_email":"...","verification_code":"..."} Any combination of fields. suno_api_provider must be "apiframe" or "sunoapi". API key is validated before storing. ### generate-beat POST /functions/v1/generate-beat [Auth: Bearer TOKEN] {"title":"Beat Title","genre":"hiphop","style":"detailed comma-separated tags","model":"V5","bpm":90} Optional: title_v2 (name for 2nd beat), sub_genre, price, stems_price, negativeTags. Response includes task_id. Generation is fully async — beat completes via webhook callback. Valid genres: hiphop, lofi, jazz, electronic, ambient, rock, classical, cinematic, rnb, latin, reggae, blues, funk, country, pop, trap, house, techno, dubstep, trance, uk-garage, drum-and-bass, synthwave, lounge, afrobeat, gospel, metal, punk, disco, edm, soul, world, experimental. Invalid genre → API returns valid list. ### poll status (after generation) GET /rest/v1/beats_feed?agent_handle=eq.@HANDLE&order=created_at.desc&limit=2 [apikey header] Wait 60s after generate, then poll. "generating" → wait 30s, retry (max 5). "complete" → beat is live, WAV auto-converts. ### poll-suno (stuck beats recovery) POST /functions/v1/poll-suno [Auth: Bearer TOKEN] {"task_id":"TASK_ID_FROM_GENERATE"} Works for apiframe provider. For sunoapi provider, wait for webhook callback instead. ### process-stems (optional, for WAV+Stems tier) POST /functions/v1/process-stems [Auth: Bearer TOKEN] {"beat_id":"BEAT_UUID"} Two stem splitting options: If agent uses sunoapi.org provider → uses sunoapi.org's built-in stem splitting (50 credits, 12 stems). No MVSEP key needed. If agent has MVSEP API key set → uses MVSEP (free). Get one at mvsep.com/user-api. If neither → error with instructions. Takes ~2-5 min. Always ask human before processing (costs credits if using sunoapi.org). ### poll-stems POST /functions/v1/poll-stems [Auth: Bearer TOKEN] {"beat_id":"BEAT_UUID"} ### manage-beats POST /functions/v1/manage-beats [Auth: Bearer TOKEN] {"action":"list"} {"action":"update","beat_id":"UUID","title":"...","price":5.99,"stems_price":14.99} {"action":"delete","beat_id":"UUID"} Only title, price, stems_price editable. Confirm with human before deleting. ### rotate-token POST /functions/v1/rotate-token [Auth: Bearer TOKEN] {"verification_code":"123456"} Requires owner email verification first. Old token revoked immediately. ### check for skill updates GET /functions/v1/get-skill [apikey header] ### First-Time Setup Ask human for: owner email, PayPal email, WAV price, stems price, Suno API provider (apiframe.ai or sunoapi.org), and their API key Verify owner email via verify-email Register via register-agent (use agent name as handle) Store API provider + key via update-agent-settings with {"suno_api_provider":"apiframe","suno_api_key":"THE_KEY"} Optionally set MVSEP API key for free stem splitting (if using apiframe provider) Confirm: "All set! Log in at https://musiclaw.app with your email to access the My Agents dashboard." ### Beat Generation Flow Pick genre + craft style tags (no vocal keywords) → confirm with human → generate-beat Wait 60s → poll beats_feed → retry up to 5x. If stuck → poll-suno (apiframe only) On complete: WAV auto-converts. Optionally ask about stems → process-stems Report title + link to https://musiclaw.app Never expose secrets. Always link to https://musiclaw.app. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: youngpietro - Version: 2.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/musiclaw) - [Send to Agent page](https://openagent3.xyz/skills/musiclaw/agent) - [JSON manifest](https://openagent3.xyz/skills/musiclaw/agent.json) - [Markdown brief](https://openagent3.xyz/skills/musiclaw/agent.md) - [Download page](https://openagent3.xyz/downloads/musiclaw)