JL Video Downloader OpenClaw技能
多平台视频下载和文案提取工具,支持抖音、快手、小红书、B站、YouTube等主流视频平台。
快速开始
1. 环境检查
bash
检查Python版本(需要 >= 3.12)
python --version
检查ffmpeg(必需)
ffmpeg --version
检查uv工具
uv --version
2. 安装工具
bash
使用uv安装(推荐)
uv tool install jl-video-downloader
使用清华镜像源安装
uv tool install jl-video-downloader --index-url https://pypi.tuna.tsinghua.edu.cn/simple
或使用阿里云镜像
uv tool install jl-video-downloader --index-url https://mirrors.aliyun.com/pypi/simple/
或使用中科大镜像
uv tool install jl-video-downloader --index-url https://pypi.mirrors.ustc.edu.cn/simple/
3. 配置环境变量
bash
API密钥配置(文案提取必需)
export SILI
FLOWAPI_KEY=sk-your-siliflow-api-key
export DEEPSEEK
APIKEY=sk-your-deepseek-api-key
代理配置(可选,用于访问YouTube等)
export YOUTUBE_PROXY=http://127.0.0.1:7897
export GLOBAL_PROXY=http://127.0.0.1:7897
输出目录配置
export OUTPUT_DIR=$HOME/videos
4. 使用封装脚本(推荐)
本技能提供了封装脚本,简化使用流程:
bash
进入脚本目录
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts
运行安装脚本(一键安装和配置)
./setup.sh install
使用封装脚本
./download.sh info <视频URL>
./download.sh download <视频URL>
./download.sh extract <视频URL>
./download.sh process <视频URL>
封装脚本提供以下优势:
- - 自动加载环境变量配置
- 统一的命令行接口
- 彩色日志输出和错误处理
- 输出目录自动管理
- 支持所有主要命令和选项
基本用法
使用封装脚本(推荐)
bash
进入脚本目录
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts
查看帮助
./download.sh help
获取视频信息
./download.sh info <视频URL>
下载视频
./download.sh download <视频URL>
./download.sh download <视频URL> -o ./my_videos
./download.sh download <视频URL> --proxy http://127.0.0.1:7897
提取文案
./download.sh extract <视频URL>
./download.sh extract <视频URL> --save-video
./download.sh extract <视频URL> --no-segment
./download.sh extract <视频URL> --api-key sk-xxx --deepseek-key sk-yyy
完整处理(下载+提取)
./download.sh process <视频URL>
批量处理
echo https://v.douyin.com/url1 > urls.txt
echo https://www.bilibili.com/video/BV1xxx >> urls.txt
./download.sh batch urls.txt
使用原生命令
bash
查看帮助
uvx jl-video-downloader --help
获取视频信息
uvx jl-video-downloader info <视频URL>
下载视频
uvx jl-video-downloader download <视频URL>
uvx jl-video-downloader download <视频URL> -o ./my_videos
uvx jl-video-downloader download <视频URL> --proxy http://127.0.0.1:7897
提取文案
uvx jl-video-downloader extract <视频URL>
uvx jl-video-downloader extract <视频URL> --save-video
uvx jl-video-downloader extract <视频URL> --no-segment
uvx jl-video-downloader extract <视频URL> --api-key sk-xxx --deepseek-key sk-yyy
完整处理(下载+提取)
uvx jl-video-downloader process <视频URL>
批量处理
uvx jl-video-downloader batch urls.txt
支持的平台
| 平台 | 支持状态 | 备注 |
|---|
| 抖音 (Douyin) | ✅ 支持 | 需要处理反爬机制 |
| 快手 (Kuaishou) |
✅ 支持 | |
| 小红书 (Xiaohongshu) | ✅ 支持 | |
| B站 (Bilibili) | ✅ 支持 | 支持BV号、短链接等格式 |
| YouTube | ✅ 支持 | 可能需要代理 |
| 其他平台 | ✅ 支持 | 通过yt-dlp支持 |
平台特定示例
使用封装脚本
bash
进入脚本目录
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts
抖音 (Douyin)
./download.sh process https://v.douyin.com/xxxxx
./download.sh process https://www.douyin.com/video/7301234567890123456
B站 (Bilibili)
./download.sh process https://www.bilibili.com/video/BV1GJ41187Q7
./download.sh process https://b23.tv/xxxxx
./download.sh process https://www.bilibili.com/video/BV1xxx?t=60
YouTube
./download.sh process https://www.youtube.com/watch?v=dQw4w9WgXcQ --proxy http://127.0.0.1:7897
./download.sh process https://www.youtube.com/playlist?list=xxxx
快手 (Kuaishou)
./download.sh process https://v.kuaishou.com/xxxxx
小红书 (Xiaohongshu)
./download.sh process https://www.xiaohongshu.com/explore/xxxxx
使用原生命令
bash
抖音 (Douyin)
uvx jl-video-downloader process https://v.douyin.com/xxxxx
uvx jl-video-downloader process https://www.douyin.com/video/7301234567890123456
B站 (Bilibili)
uvx jl-video-downloader process https://www.bilibili.com/video/BV1GJ41187Q7
uvx jl-video-downloader process https://b23.tv/xxxxx
uvx jl-video-downloader process https://www.bilibili.com/video/BV1xxx?t=60
YouTube
uvx jl-video-downloader process https://www.youtube.com/watch?v=dQw4w9WgXcQ --proxy http://127.0.0.1:7897
uvx jl-video-downloader process https://www.youtube.com/playlist?list=xxxx
快手 (Kuaishou)
uvx jl-video-downloader process https://v.kuaishou.com/xxxxx
小红书 (Xiaohongshu)
uvx jl-video-downloader process https://www.xiaohongshu.com/explore/xxxxx
高级配置
脚本工具
本技能提供了完整的脚本工具集,位于 ~/.openclaw/workspace/skills/jl-video-downloader/scripts/ 目录:
| 文件 | 说明 |
|---|
| download.sh | 主封装脚本,提供统一的命令行接口 |
| setup.sh |
安装和配置脚本,一键安装工具和配置环境 |
| env.example | 环境变量配置示例文件 |
| README.md | 脚本使用说明文档 |
快速配置:
bash
进入脚本目录
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts
一键安装和配置
./setup.sh install
仅创建配置文件
./setup.sh config
测试安装
./setup.sh test
持久化环境变量
创建配置文件 ~/.jl-video-downloader/env:
bash
API密钥
SILI
FLOWAPI_KEY=sk-your-siliflow-key
DEEPSEEK
APIKEY=sk-your-deepseek-key
代理设置
YOUTUBE_PROXY=http://127.0.0.1:7897
GLOBAL_PROXY=http://127.0.0.1:7897
输出设置