jl-video-downloader OpenClaw Skill

多平台视频下载和文案提取工具。支持抖音、快手、小红书、B站、YouTube等平台的视频下载和语音转文字功能。当用户需要下载视频、提取视频文案或批量处理视频时激活此技能。

v1.0.1 Recently Updated Updated 2 days ago

Installation

clawhub install jl-video-downloader

Requires npm i -g clawhub

View on ClawHub Download .zip

38

Downloads

0

Stars

0

current installs

0 all-time

2

Versions

JL Video Downloader OpenClaw Skill

多平台视频下载和文案提取工具，支持抖音、快手、小红书、B站、YouTube等主流视频平台。

快速开始

1. 环境检查

# 检查Python版本（需要 >= 3.12）
python --version

# 检查ffmpeg（必需）
ffmpeg --version

# 检查uv工具
uv --version

2. 安装工具

# 使用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. 配置环境变量

# API密钥配置（文案提取必需）
export SILI_FLOW_API_KEY="sk-your-siliflow-api-key"
export DEEPSEEK_API_KEY="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. 使用封装脚本（推荐）

本技能提供了封装脚本，简化使用流程：

# 进入脚本目录
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>

封装脚本提供以下优势：

  • 自动加载环境变量配置
  • 统一的命令行接口
  • 彩色日志输出和错误处理
  • 输出目录自动管理
  • 支持所有主要命令和选项

基本用法

使用封装脚本（推荐）

# 进入脚本目录
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

使用原生命令

# 查看帮助
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支持

平台特定示例

使用封装脚本

# 进入脚本目录
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"

使用原生命令

# 抖音 (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 脚本使用说明文档

快速配置：

# 进入脚本目录
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts

# 一键安装和配置
./setup.sh install

# 仅创建配置文件
./setup.sh config

# 测试安装
./setup.sh test

持久化环境变量

创建配置文件 ~/.jl-video-downloader/env：

# API密钥
SILI_FLOW_API_KEY="sk-your-siliflow-key"
DEEPSEEK_API_KEY="sk-your-deepseek-key"

# 代理设置
YOUTUBE_PROXY="http://127.0.0.1:7897"
GLOBAL_PROXY="http://127.0.0.1:7897"

# 输出设置
OUTPUT_DIR="$HOME/Downloads/videos"
VIDEO_FILENAME_TEMPLATE="{platform}_{date}_{title}"

# 下载设置
DOWNLOAD_TIMEOUT=600
MAX_RETRIES=5
CONCURRENT_DOWNLOADS=3

# 日志设置
LOG_LEVEL="INFO"
LOG_FILE="$HOME/.jl-video-downloader/video-dl.log"

使用脚本自动配置：

# 复制示例配置文件
cp ~/.openclaw/workspace/skills/jl-video-downloader/scripts/env.example ~/.jl-video-downloader/env

# 编辑配置文件
nano ~/.jl-video-downloader/env

# 加载配置
source ~/.jl-video-downloader/load_env.sh

添加到shell配置

# 添加到 ~/.bashrc 或 ~/.zshrc
echo 'source ~/.jl-video-downloader/load_env.sh' >> ~/.bashrc

# 或使用脚本自动添加
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts
./setup.sh config

故障排除

常见问题

1. "uv: command not found"

# 安装uv工具
curl -LsSf https://astral.sh/uv/install.sh | sh
# 或
pip install uv

2. "ffmpeg: command not found"

# Ubuntu/Debian
sudo apt-get install ffmpeg

# macOS
brew install ffmpeg

# CentOS/RHEL
sudo yum install ffmpeg

3. API密钥错误

# 检查环境变量
echo $SILI_FLOW_API_KEY
echo $DEEPSEEK_API_KEY

# 重新配置
echo 'export SILI_FLOW_API_KEY="sk-your-key"' >> ~/.jl-video-downloader/env
source ~/.jl-video-downloader/load_env.sh

4. 代理连接失败

# 测试代理
curl --proxy http://127.0.0.1:7897 https://www.google.com

# 更新代理配置
echo 'export YOUTUBE_PROXY="http://127.0.0.1:7897"' >> ~/.jl-video-downloader/env
source ~/.jl-video-downloader/load_env.sh

5. 下载速度慢

# 使用代理
uvx jl-video-downloader download <URL> --proxy http://127.0.0.1:7897

# 调整超时时间
export DOWNLOAD_TIMEOUT=600

脚本相关故障

1. "download.sh: command not found"

# 确保在正确的目录
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts

# 检查脚本权限
chmod +x download.sh setup.sh

# 或使用完整路径
~/.openclaw/workspace/skills/jl-video-downloader/scripts/download.sh help

2. 脚本执行权限问题

# 添加执行权限
chmod +x ~/.openclaw/workspace/skills/jl-video-downloader/scripts/*.sh

# 检查权限
ls -la ~/.openclaw/workspace/skills/jl-video-downloader/scripts/

3. 环境变量未加载

# 手动加载环境变量
source ~/.jl-video-downloader/load_env.sh

# 或重新运行安装脚本
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts
./setup.sh config

调试模式

# 使用封装脚本的调试模式
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts
export LOG_LEVEL="DEBUG"
./download.sh info <URL>

# 查看详细日志
bash -x ./download.sh info <URL>

# 查看原生命令的详细日志
export LOG_LEVEL="DEBUG"
uvx jl-video-downloader process <URL>

# 查看Python错误
python -c "import main; main.main()" --help

在OpenClaw工作流中的使用

使用封装脚本的工作流

#!/bin/bash
# openclaw_video_workflow.sh

# 1. 设置脚本目录
SCRIPT_DIR="$HOME/.openclaw/workspace/skills/jl-video-downloader/scripts"

# 2. 检查并安装工具
if [[ -x "$SCRIPT_DIR/setup.sh" ]]; then
    "$SCRIPT_DIR/setup.sh" install
else
    echo "错误: 未找到setup.sh脚本"
    exit 1
fi

# 3. 处理视频
URL="$1"
OUTPUT_DIR="${2:-./output}"

echo "开始处理视频: $URL"
echo "输出目录: $OUTPUT_DIR"

# 4. 使用封装脚本进行完整处理
"$SCRIPT_DIR/download.sh" process "$URL" -o "$OUTPUT_DIR"

# 5. 输出结果
echo "视频处理完成"
echo "输出文件:"
ls -la "$OUTPUT_DIR/"

直接在OpenClaw中调用

# 使用封装脚本
exec "cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts && ./download.sh process \"https://www.douyin.com/video/7596260211384388904\""

# 获取视频信息
exec "cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts && ./download.sh info \"https://www.bilibili.com/video/BV1xxx\""

# 批量处理URL文件
exec "cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts && echo 'https://v.douyin.com/url1' > urls.txt && ./download.sh batch urls.txt"

与其他技能集成

# 在browser技能后使用封装脚本
browser extract "获取页面中的视频链接" | while read url; do
    cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts && ./download.sh download "$url" -o ./videos
done

# 与data-scraper技能结合
scraper extract "video_urls" > urls.txt
cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts && ./download.sh batch urls.txt

# 与crawl4ai技能集成
crawl4ai extract "video_links" | xargs -I {} cd ~/.openclaw/workspace/skills/jl-video-downloader/scripts && ./download.sh info "{}"

性能优化

并发下载

# 调整并发数
export CONCURRENT_DOWNLOADS=5

# 使用parallel工具进行批量并发
cat urls.txt | parallel -j 5 "uvx jl-video-downloader download {}"

缓存配置

# 设置缓存目录
export VIDEO_DOWNLOADER_CACHE_DIR="$HOME/.cache/jl-video-downloader"

# 清理缓存
rm -rf ~/.cache/jl-video-downloader/*

更新和维护

更新工具

# 更新uv
uv self update

# 更新jl-video-downloader
uv tool upgrade jl-video-downloader

重新安装

# 卸载
uv tool uninstall jl-video-downloader

# 重新安装
uv tool install jl-video-downloader

备份配置

# 备份配置
cp -r ~/.jl-video-downloader ~/.jl-video-downloader.backup

# 恢复配置
cp -r ~/.jl-video-downloader.backup ~/.jl-video-downloader

许可证

MIT License

脚本工具参考

download.sh 完整选项

# 基本语法
./download.sh <命令> [选项] <参数>

# 命令列表
./download.sh info      <视频URL>    # 获取视频信息
./download.sh download  <视频URL>    # 下载视频
./download.sh extract   <视频URL>    # 提取文案
./download.sh process   <视频URL>    # 完整处理
./download.sh batch     <文件>       # 批量处理
./download.sh help                 # 显示帮助
./download.sh --version            # 显示版本

# 常用选项
-o, --output DIR      # 指定输出目录
-p, --proxy URL       # 指定代理服务器
--api-key KEY         # 设置SILI_FLOW_API_KEY
--deepseek-key KEY    # 设置DEEPSEEK_API_KEY
--no-segment          # 禁用语义分段
--save-video          # 提取文案时保存视频

setup.sh 功能

# 完整安装和配置
./setup.sh install

# 仅创建配置文件
./setup.sh config

# 测试安装
./setup.sh test

# 显示帮助
./setup.sh help

支持与反馈

如有问题或建议，请通过以下方式反馈：

  1. 项目GitHub Issues
  2. OpenClaw社区
  3. 开发者邮箱

使用提示:

  1. 首次使用前请确保配置好API密钥和ffmpeg工具
  2. 对于YouTube视频，可能需要配置代理服务器
  3. 推荐使用封装脚本 download.sh，提供更好的用户体验和错误处理
  4. 使用 setup.sh 可以一键完成安装和配置

Statistics

Downloads 38
Stars 0
Current installs 0
All-time installs 0
Versions 2
Comments 0
Created Apr 2, 2026
Updated Apr 3, 2026

Latest Changes

v1.0.1 · Apr 3, 2026

## jl-video-downloader 1.0.1 - 新增 `scripts/download.sh`、`scripts/setup.sh`：提供一键安装与主命令封装脚本，简化使用流程。 - 新增 `scripts/env.example`：示例环境变量配置文件，便于快速上手和环境管理。 - 新增 `scripts/README.md`：详细说明脚本工具的安装与用法。 - 文档大幅更新，增加推荐使用脚本工具的说明与高级配置、故障排查、自动加载环境等内容。

Quick Install

clawhub install jl-video-downloader

Related Skills

Other popular skills you might find useful.

MaTriXy

Agent Browser

MaTriXy

Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection

69.5k 250 v0.1.0
peytoncasper

Browser Automation

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

31.9k 46 v1.0.1
Iván

Code

Iván

Coding workflow with planning, implementation, verification, and testing for clean software development.

18.3k 35 v1.0.4
peytoncasper

Agent Browser - Stagehand

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

6.3k 4 v1.0.0
Browse all skills →
EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing