A smart media retrieval skill that downloads video and audio from various platforms directly into organized local folders.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install dl
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 dl 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 Media Downloader?
Media Downloader is a robust tool within the Openclaw Skills ecosystem designed to streamline the process of capturing online content. It automatically categorizes downloads, placing videos into ~/Movies and audio into ~/Music, making it an essential utility for users who manage local media libraries. By leveraging the speed of uv and the versatility of specialized scripts, this skill bridges the gap between web-based content and your local storage infrastructure.
Whether you are building a personal archive or feeding a home media server, this skill provides a hands-off approach to media management. It is engineered to handle complex tasks like playlist downloading and Telegram integration, ensuring that your content is always where you need it, when you need it.
Media Downloader Use Cases
- Automatically download videos from YouTube or Bilibili to your local Movies folder.
- Extract audio tracks from social media links and save them directly to your Music library.
- Archive entire media playlists into structured sub-folders for easy browsing.
- Forward downloaded MP3 or M4A files directly to your Telegram account for mobile access.
- Sync downloaded content with local DLNA servers for instant playback on smart TVs.
How Media Downloader Works
- The user provides a media URL or a natural language command to initiate the download.
- The skill acknowledges the request and prepares the execution environment using the Openclaw Skills protocol.
- The underlying script is executed through uv run, processing the URL to identify the best available media format.
- Files are saved to the appropriate system directory based on whether the content is classified as music or video.
- The skill captures the final file or folder path from the output for further processing.
- For Telegram-based sessions, audio files are automatically uploaded and sent to the user as a message.
Media Downloader Setup
To utilize this and other Openclaw Skills, ensure you have the uv package manager installed. Follow these steps to set up the downloader:
# Install the required uv tool if not already present
curl -LsSf https://astral.sh/uv/install.sh | sh
# Run the download script with a target URL
uv run --script dl.py "<url>"
# Optionally specify a custom output directory
uv run --script dl.py "<url>" -o <custom_dir>
For enhanced reliability on platforms with authentication, place a .cookies.txt file in the base directory or set the $COOKIES_FILE environment variable.
Media Downloader Data Schema & Taxonomy
The Media Downloader skill follows a strict organizational taxonomy to ensure your media remains accessible and tidy:
| Media Type | Destination Folder | Description |
|---|---|---|
| Video Content | ~/Movies/ or ~/Videos/ | Standard video files from YouTube, X, etc. |
| Audio Content | ~/Music/ | Extracted music or podcast files. |
| Playlists | ~/Music/ |
Organized subdirectories for grouped items. |
| Metadata | .cookies.txt | Optional authentication data for restricted URLs. |
Media Downloader Advanced Features
- Multi-platform support for macOS, Linux, and Windows environments.
- Automatic integration with Telegram for seamless mobile file delivery of audio content.
- Flexible cookie management to bypass platform restrictions and bot detection.
- Optimized for local media servers like Jellyfin, miniDLNA, and Universal Media Server.
- Intelligent playlist handling that preserves album and series structures automatically.
SKILL.md
Loading
Related Openclaw Skills
Zhihu Hot List Monitor
A specialized monitoring tool designed to fetch, filter, and analyze the most popular trending topics and questions on Zhihu.
Xueqiu Hot Discussions Monitor
A monitoring tool for fetching real-time trending stock discussions and investment insights from the Xueqiu platform.
Xiaohongshu Analysis
A comprehensive toolset for discovering trending content, monitoring keywords, and performing market analysis on Xiaohongshu.
WorldQuant Alpha Miner
An AI-powered system for automated generation, simulation, and submission of WorldQuant Alpha factors using local LLMs.
HackerNews Extract
A utility that extracts a HackerNews post, including the linked article and all threaded comments, into a single, well-formatted Markdown document.
MLX Audio Server
A local, 24/7 OpenAI-compatible API server for high-performance STT and TTS powered by the MLX framework on macOS.
METADATA
Featured*
