A specialized AI agent skill designed to automate Suno AI music production on headless Linux cloud servers using virtual display technology.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install suno-headless-skill
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 suno-headless-skill 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 Suno Headless Music Creator?
The Suno Headless skill is a robust solution for developers and creators who need to generate high-quality AI music directly from a server environment. Unlike standard automation tools that are often blocked by Google and Suno bot detection, this skill utilizes Xvfb (X Virtual FrameBuffer) to run a full instance of Google Chrome in memory. This allows it to simulate a real user interface on headless systems, providing a seamless bridge between Openclaw Skills and Suno's creative engine.
By integrating this skill into your workflow, you can automate the entire lifecycle of music production—from authentication via Google OAuth or cookie injection to lyrics submission and MP3 delivery. It is specifically optimized for Linux distributions like Ubuntu, ensuring that cloud-based AI agents can perform audio tasks without requiring a physical monitor or a desktop environment.
Suno Headless Music Creator Use Cases
- Deploying automated music generation bots on remote VPS or cloud instances.
- Integrating professional AI audio production into server-side developer workflows.
- Bypassing headless browser restrictions during Google OAuth and Suno login processes.
- Batch processing song creation from text files or external databases.
How Suno Headless Music Creator Works
- The skill performs an environmental check to ensure Xvfb, Google Chrome, and required fonts are installed on the Linux system.
- It initiates a session using either a secure cookie import or Gmail credentials, running Chrome in a virtualized GUI mode to avoid detection.
- A specific hCaptcha patch is applied, and the Gemini API is utilized to automatically solve visual challenges during the song creation process.
- Lyrics and musical style parameters are submitted to the Suno interface through a Playwright-driven automation layer.
- The system monitors the production status via internal APIs and automatically downloads the finished MP3 files to a designated output directory.
Suno Headless Music Creator Setup
First, install the necessary system dependencies on your Linux server:
sudo apt update && sudo apt install -y xvfb google-chrome-stable fonts-noto-cjk
Next, install the Python environment and browser binaries:
cd suno-headless
pip3 install -r requirements.txt
playwright install
Finally, configure your Gemini API key for hCaptcha solving and verify the installation:
echo "GEMINI_API_KEY=your_key_here" > ~/.suno/.env
bash suno-headless/check_env.sh
Suno Headless Music Creator Data Schema & Taxonomy
The skill organizes its configuration and output using the following structure:
| Component | Path | Description |
|---|---|---|
| Config Directory | ~/.suno/ |
Stores persistent browser profiles and environment secrets. |
| Session Cookies | suno_cookies.json |
JSON formatted tokens used for authenticated sessions. |
| Audio Output | output_mp3/ |
Default location for all downloaded AI-generated music files. |
| Logs | suno-headless/logs/ |
Detailed execution traces for debugging and performance monitoring. |
Suno Headless Music Creator Advanced Features
- Xvfb Virtualization: Emulates a 1280x800 display in system memory to run GUI-only applications on CLI servers.
- Intelligent Captcha Handling: Leverages the Gemini API for autonomous hCaptcha resolution without manual intervention.
- Flexible Authentication: Supports both direct OAuth login and secure session cookie migration from local machines.
- Headless Optimization: Automatically detects the absence of a display environment and toggles virtual display drivers as needed within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Presentation & Technical Content Generator
An automated system for generating professional Reveal.js slide decks and technical articles directly from source code and research papers.
Guide Creator
Guide Creator is a specialized documentation system that generates and maintains standardized project guides to ensure seamless AI context recovery and development continuity.
Red Team - Adversarial Debate Engine
An adversarial multi-agent engine that orchestrates AI personas with conflicting worldviews to stress-test decisions and strategies through structured debate.
TooToo
Sync your personal TooToo codex to monitor and enforce AI agent alignment with your core values and principles.
Suno AI Music Creator
A comprehensive automation skill for Suno AI that handles authentication, custom song generation, and audio file management.
Cloudflare
A comprehensive automation interface to manage Cloudflare DNS, security, CDN settings, and serverless Workers via API.
METADATA
Featured*
