A universal music downloader and manager that extracts audio from YouTube and Bilibili, converts it to MP3, and organizes it into local libraries.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install music-manager
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 music-manager 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 Music Manager?
Music Manager is a robust automation tool designed to help developers and media enthusiasts build and maintain a high-quality local music library. By integrating seamlessly into your Openclaw Skills ecosystem, it allows for the automated extraction of audio from video platforms like YouTube and Bilibili. The skill focuses on streamlining the tedious parts of media management: searching, downloading, transcoding, and filing.
Whether you are using it as a standalone CLI tool or through an AI agent, Music Manager ensures that your audio files are consistently formatted and properly categorized. It is a perfect example of how Openclaw Skills can bridge the gap between web content and local file systems with minimal user intervention.
Music Manager Use Cases
- Extracting high-quality audio tracks from YouTube music videos for offline listening.
- Archiving soundtracks and covers from Bilibili content directly into categorized folders.
- Using an AI agent to search for songs and download them based on conversational prompts.
- Building a structured local music repository with standardized naming conventions.
How Music Manager Works
- The user inputs a search query or a direct URL from a supported video platform.
- The system invokes yt-dlp to locate and download the highest quality audio stream available.
- ffmpeg is automatically triggered to transcode the downloaded media into a standardized MP3 format.
- The skill parses metadata to rename the file according to the 'Song-Artist-Source' naming convention.
- The final file is moved into a specific subfolder based on the user-provided category within the main music directory.
Music Manager Setup
1. Install System Dependencies
Ensure you have the necessary media tools installed on your system:
# Install yt-dlp and ffmpeg via Homebrew
brew install yt-dlp ffmpeg
2. Configure Music Path
Edit the configuration in scripts/download_music.py to point to your desired storage location:
MUSIC_DIR = "~/Music" # Set your local music directory path
3. Optional Cookie Configuration
To avoid download restrictions on certain platforms, you can enable browser cookie extraction:
# Edit the BROWSER variable in the script
BROWSER = "chrome" # Options: chrome, safari, firefox, or None
Music Manager Data Schema & Taxonomy
Music Manager organizes data using a hierarchical folder structure and a strict naming convention to ensure your Openclaw Skills library remains searchable.
| Attribute | Format / Logic |
|---|---|
| Root Directory | Defined by the MUSIC_DIR variable |
| Sub-folders | Grouped by the Category argument (e.g., Chinese, Gaming, Jazz) |
| Filename | Title-Author-Source.mp3 |
| Audio Format | MP3 (converted via ffmpeg) |
| Metadata | Derived from platform search results |
Music Manager Advanced Features
- Multi-Platform Support: Seamlessly handles both YouTube and Bilibili URLs and search queries.
- AI Agent Integration: Supports a conversational workflow where the agent presents search results for user confirmation before initiating the download.
- Automatic Transcoding: Intelligent ffmpeg hooks ensure all downloads are normalized to MP3 regardless of source format.
- Browser Cookie Sync: Ability to leverage existing browser sessions to bypass bot detection and access age-restricted content.
- Dynamic Categorization: Automatically creates and manages directory structures based on user tags.
SKILL.md
Loading
Related Openclaw Skills
Runware
A comprehensive media generation skill for creating, upscaling, and animating high-fidelity images and videos via the Runware API.
Token Risk Explainer Skill
An automated utility that translates technical Binance Web3 token audit data into plain-language risk assessments and social media drafts.
Meme Risk Radar Skill
A bilingual meme token risk analysis engine that transforms Binance Web3 discovery data into actionable, risk-scored insights.
Alpha Copilot Skill
A research automation tool that generates a daily top-5 crypto token leaderboard with risk summaries and ready-to-publish social media drafts.
Gaode Map (AMap) Integration
A Python-based skill for integrating Gaode Map (AMap) capabilities like POI search and multi-modal route planning into AI agent workflows.
MikroTik RouterOS Management Skill
A comprehensive AI agent skill for managing MikroTik RouterOS devices through API-driven automation and real-time monitoring.
Featured*
