Clip
/install clip-media
Clip
Drop a URL → get the media back. Fast.
How It Works
- User shares a URL from any supported platform
- Run the extraction script
- Script downloads the media (or just analyzes it)
- Returns the file path (under 50 MB) or a cloud link (over 50 MB)
- Agent sends the media to the user
Command
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js \x3Curl> [options]
Options
| Flag | Description |
|---|---|
--output-dir \x3Cdir> |
Save location (default: /tmp/media-share) |
--title |
Return title/description only, no download |
--info |
Return full metadata as JSON |
--test |
Validate URL without downloading |
--upload |
Force cloud upload even for small files |
--cloud=\x3Cprovider> |
Cloud provider: tmpfiles or transfer |
--no-direct-send |
Always return path, never auto-send |
--list-sites |
Show supported platforms |
--list-types |
Show what media a URL contains |
Examples
# Download media (fastest path)
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
# Get title only (no download, instant)
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js "https://www.instagram.com/p/abc123/" --title
# Check what's in a URL before downloading
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js "https://www.tiktok.com/@user/video/123" --list-types
# Show supported sites
node /home/jarvis/.openclaw/workspace/skills/clip/extract.js --list-sites
Supported Platforms
yt-dlp: 1,872 extractors — covers essentially every major media platform on the internet.
Quick reference (most common):
YouTube, TikTok, Instagram, X/Twitter, Facebook, Reddit, Twitch, Vimeo, Dailymotion, Rumble, Peertube, Bilibili, Niconico, SoundCloud, Bandcamp, Pinterest, Imgur, Tumblr, Flickr, Bluesky, Telegram, Kick, Odysee, CNN, BBC, Al Jazeera, TED, Khan Academy, Udemy, Crunchyroll, HiDive, and 1,800+ more.
File Size Handling
- Under 50 MB → Returns local file path (agent sends via chat)
- Over 50 MB → Auto-uploads to temp cloud storage, returns download link
- Over 50 MB +
--upload→ Forces cloud upload even for smaller files
Cloud Providers
| Provider | Max Size | Notes |
|---|---|---|
tmpfiles |
50 MB | Simple, no signup, auto-delete |
transfer |
Unlimited | transfer.sh, 30-day retention |
Authentication
Some platforms require cookies for full access:
| Platform | Needs cookies? |
|---|---|
| Sometimes (private content, full resolution) | |
| X / Twitter | Sometimes (rate limits, some content) |
| Patreon | Yes (paid content) |
| OnlyFans | Yes |
| Fanvue / Fansly | Yes |
| Netflix / HBO / Disney+ | Via browser cookies |
| YouTube | Rarely (age-restricted content) |
Add --cookies-from-browser chrome to the command when needed.
How It Works (Under the Hood)
- Analyze:
yt-dlp --dump-jsondetects the platform and media type - Download:
yt-dlp -o \x3Cpath>grabs the highest quality version - Route: Under 50 MB → return path. Over 50 MB → upload to cloud → return link
- Fallback: If download fails, returns title/description so the agent can inform the user
Dependencies
yt-dlp(installed) — 1,872 extractorsffmpeg(installed) — format conversioncurl(installed) — cloud uploads
Error Handling
When a URL returns no media, the script returns the title/description. The agent should:
- Inform the user what was found
- Suggest trying
--cookies-from-browser chromeif the platform may require auth - Note that geo-blocked content cannot be bypassed
Notes
- Rate limits may apply on some platforms — add delays between calls
- Some platforms (Instagram, X) work better with cookies
- If a URL returns no media, return the title/description to the user instead
- The
genericextractor handles many embedded video players not explicitly listed
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install clip-media - 安装完成后,直接呼叫该 Skill 的名称或使用
/clip-media触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Clip 是什么?
Extract media (videos, photos, GIFs, audio) from social media URLs using yt-dlp. Supports 1,872+ platforms including YouTube, TikTok, Instagram, X/Twitter, F... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 50 次。
如何安装 Clip?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install clip-media」即可一键安装,无需额外配置。
Clip 是免费的吗?
是的,Clip 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Clip 支持哪些平台?
Clip 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Clip?
由 jlacroix82(@jlacroix82)开发并维护,当前版本 v0.1.0。