Name: Media Downloader
Author: guoqiao

据 AlphaMoat 统计,截至 2026-09,Media Downloader 累计下载 4,428 次、获 5 个星标,在全部 5,078 个 AI 技能中排名第 2,197 位,在「设计创意」分类(512 个)中排名第 214 位。

累计安装

437

累计下载

4,428

星标

全站排名

#2,197

全站前 44% · 「设计创意」前 42%

平台	累计安装	累计下载	星标	评论
ClawHub ↗	137	4,211	5	-
SkillHub ↗	437	4,428	5	—

各平台的计数口径不同,统计时间不一致。

这个技能是做什么的

脚本通过uv运行，按媒体类型保存到视频或音乐文件夹，并返回文件或列表目录路径。可指定输出目录和可选cookies文件；Telegram音频发送属于单独的交付分支。下载会占用磁盘空间，文件也可能被局域网媒体服务器共享。请使用专用目录并保护 cookies 文件。本版本还设有播放列表数量和文件大小上限；可选 Telegram 发送前先核对聊天对象与文件。

资料发布于 2026-10-27

可以用来做什么

按类型整理下载的媒体

什么时候用

用户提供媒体URL并指定下载需求时

示例提示词

以下是根据技能文档生成的示例,不代表实际运行结果。

说明该媒体链接的下载参数和输出位置，暂不下载或发送。

月度数据趋势

累计下载4,428

星标5

2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。

月份	累计下载	环比	星标
2026-09	4,428	—	5
2026-08	4,046	+4.7%	5
2026-07	3,864	+7.3%	5
2026-06	3,600	+3.0%	5
2026-05	3,495	—	5
2026-03	3,163	—	5

SKILL.md 原文

以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。

2.5 KB · ClawHub v0.2.3

---
name: dl
description: Download Video/Music from YouTube/Bilibili/X/etc.
author: guoqiao
metadata: {"openclaw":{"always":false,"emoji":"🦞","homepage":"https://clawhub.ai/guoqiao/dl","os":["darwin","linux","win32"],"requires":{"bins":["uv"]}}}
triggers:
- "/dl <url>"
- "Download this video ..."
- "Download this music ..."
---

展开全部(共 77 行)


# Media Downloader

Smartly download media (Video/Music) from URLs (YouTube, Bilibili, X, etc.) to the appropriate local folders.

- **Video:** Save into `~/Movies/` or `~/Videos/`.
- **Music:** Save into `~/Music/`.
- **Playlists:** Saves items into a subdirectory (e.g., `~/Music/<playlist_name>/`).

Designed to work with a local Media Server (e.g., Universal Media Server, Jellyfin) for instant playback on TV/devices.

## Agent Procedure

When the user provides a URL or asks to download media, **you MUST follow this exact sequence:**

1. **Acknowledge:**
   - Immediately reply to the user: "Downloading with dl skill..."

2. **Execute:**
   - Run the script:
     ```bash
     uv run --script ${baseDir}/dl.py "<url>"
     ```

3. **Capture Path:**
   - Read the script output, a path will be printed to stdout at the end, points to either a single file or a folder contains the playlist items.

4. **Upload (Telegram Only):**
   - If the user is on Telegram (check context or session) AND the file is audio (mp3/m4a):
   - Use the `message` tool to send the file to the user:
     ```json
     {
       "action": "send",
       "filePath": "<filepath>",
       "caption": "Here is your music."
     }
     ```

## Usage

Run `dl.py` as a uv script:
```bash
# save into default dirs ~/Music or ~/Movies or ~/Videos
uv run --script ${baseDir}/dl.py <url>

# specify your own output dir
uv run --script ${baseDir}/dl.py <url> -o <out_dir>
```
The script will print output path, either a file or a folder.

A optional cookies file could be provided to make yt-dlp more reliable, with which ever of these detected first:

- `${baseDir}/.cookies.txt`
- `$DL_COOKIES_FILE`
- `$COOKIES_FILE`
- `~/.cookies.txt`

## Setup (User)

This skill will be much more useful if you setup a media server on same machine to share the downloaded media in your LAN:

1. Install a DLNA/UPnP Media Server (Universal Media Server, miniDLNA, Jellyfin).
2. Share `~/Music` and `~/Movies` (or `~/Videos`) folders.
3. Downloaded media will appear automatically on your TV, with apps support DLNA/UPnP, such as VLC.

See [example script](https://github.com/guoqiao/skills/blob/main/dl/ums/ums_install.sh) to setup Universal Media Server on Mac.