An AI-powered music and audio generation skill that integrates SunoAPI directly into your automated workflows via the OOMOL-connected oo CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oo-sunoapi
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install oo-sunoapi using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SunoAPI AI Music Generation Skill?
The SunoAPI skill enables developers and AI agents to programmatically interact with SunoAPI (sunoapi.org) to generate high-quality AI music, vocals, instrumentals, lyrics, and music videos. By leveraging the oo CLI and OOMOL's secure server-side credential management, you do not have to handle raw tokens or API keys locally. This makes it an incredibly secure and powerful tool to integrate into your automated pipelines.
Whether you are looking to dynamically generate background tracks, write song lyrics, create custom music videos, or convert audio formats, this addition to your library of Openclaw Skills bridges the gap between state-of-the-art music generation models and your local coding environment. You can query schemas, trigger state-changing writes, and check operation credits safely and quickly.
SunoAPI AI Music Generation Skill Use Cases
- Automated Soundtrack Creation: Programmatically generate background music or sound effects for videos, podcasts, and games based on textual prompts.
- Dynamic Lyrics & MIDI Generation: Draft song lyrics and export MIDI or timestamped lyrics automatically within your creative application pipeline.
- Audio Separation & Enhancement: Extract vocals, convert tracks to high-quality WAV formats, and boost existing music styles programmatically.
- Vocal Overdubbing: Submit vocal or instrumental addition tasks to existing musical templates without manual interface interaction.
How SunoAPI AI Music Generation Skill Works
- Contract Inspection: The AI agent queries the live SunoAPI schema using
oo connector schema 'sunoapi' --action '<action_name>'to understand inputs and outputs dynamically before sending request payloads. - Payload Preparation: A JSON payload containing generation prompt, style, or vocal specifications is formulated based on the fetched schema.
- Task Execution: The action is triggered via the oo CLI with OOMOL securely injecting the credentials server-side.
- Task Polling & Tracking: The system returns a unique execution or task identifier which is tracked to fetch generation results (e.g., lyrics details, MIDI details, or audio files).
SunoAPI AI Music Generation Skill Setup
1. Install the CLI
Install the required oo CLI on your operating system if you have not already.
On macOS/Linux:
curl -fsSL https://cli.oomol.com/install.sh | bash
On Windows (PowerShell):
irm https://cli.oomol.com/install.ps1 | iex
2. Log In
Authenticate your local environment with your OOMOL account:
oo auth login
3. Connect SunoAPI
Configure your SunoAPI connection (using your API key) by visiting your console at OOMOL App Connections. This connects your account securely to use this option among your available Openclaw Skills.
4. Billing & Credits
Ensure you have sufficient credits allocated. You can recharge at any time on the OOMOL billing page.
SunoAPI AI Music Generation Skill Data Schema & Taxonomy
The SunoAPI skill processes inputs as JSON structures and outputs execution metadata alongside task identifiers. Below is the structured data workflow:
| Attribute | Description |
|---|---|
| Action Name | Unique identifier for the SunoAPI capability (e.g., generate_music, add_vocals). |
Payload (--data) |
A valid JSON object or path reference matching the schema of the specified action. |
| Response Data | A JSON object containing the generation results or a unique task identifier under the data key. |
| Response Metadata | Operation metadata detailing the execution tracking under meta.executionId. |
All output data schema specs must be verified live dynamically using the oo connector schema 'sunoapi' --action '<action_name>' command.
SunoAPI AI Music Generation Skill Advanced Features
- Dynamic Live Schema Contracts: Retrieve up-to-the-minute API input structures on-the-fly, ensuring compatibility even if upstream endpoints change.
- Server-Side Token Injection: Avoid exposing raw API tokens in your local code environment, making this one of the safest Openclaw Skills to deploy in multi-tenant or shared environments.
- State Safety Categorization: Transparent segregation between read-only actions and state-changing (write/destructive) modifications, permitting explicit approval gates before any execution.
- Comprehensive Multi-Format Support: Generate and convert between various audio files, MIDI outputs, video formats, and timestamped subtitle files seamlessly.
SKILL.md
Loading
Related Openclaw Skills
TaxJar Integration (oo-taxjar)
An AI-ready integration for TaxJar that automates sales tax calculation, transactions, customer exemption management, and VAT verification via a secure CLI connector.
oo-tomtom
An Openclaw Skills integration that empowers AI agents to execute TomTom spatial search, geocoding, autocomplete, and mapping operations securely through the OOMOL CLI.
Typeform Skill for AI Agents
An AI-ready wrapper to interact with Typeform's API securely via OOMOL, allowing seamless form, workspace, and response management.
oo-weatherapi
A secure, CLI-driven skill to retrieve real-time weather, forecast, astronomy, and timezone data from WeatherAPI.
ShortPixel Integration
An automated image optimization and CDN caching skill that enables AI agents to configure domains, purge caches, and track CDN metrics using ShortPixel.
oo-smugmug
A robust AI agent skill for interacting with the SmugMug API through the OOMOL-connected oo CLI without handling raw tokens.
Featured*
