ClawHub

视频下载与转录(Whisper)

Other

下载无法直接访问的视频网站内容（如B站、YouTube等），提取音频后用Whisper转录成文字。适用场景：用户要求分析某个视频内容，但链接被封锁无法直接访问；需要获取视频完整文字稿进行深度分析。

Install

openclaw skills install video-download-whisper

视频下载与转录工作流

适用场景

  • 视频链接被封锁（如b23.tv短链接）
  • 无法直接访问视频页面获取内容
  • 需要获取视频完整文字稿进行深度分析
  • 无需翻墙即可下载YouTube等被限制的平台

支持的平台

🌏 中国平台

平台说明命令示例
B站/哔哩哔哩视频、番剧、音频、收藏夹yt-dlp "https://www.bilibili.com/video/BVxxx"
抖音/Douyin短视频yt-dlp "https://www.douyin.com/video/xxx"
小红书/XiaoHongShu图文/视频笔记yt-dlp "https://www.xiaohongshu.com/explore/xxx"
快手短视频yt-dlp "https://www.kuaishou.com/short-video/xxx"
微博视频微博视频yt-dlp "https://weibo.com/xxx"
美拍/Meipai视频yt-dlp "https://www.meipai.com/media/xxx"
爱奇艺iQiyi视频yt-dlp "https://www.iq.com/play/xxx"
优酷Youku视频yt-dlp "https://v.youku.com/v_show/id_xxx"
百度视频BaiduVideoyt-dlp "https://video.baidu.com/v/xxx"

🌍 国际平台

平台说明命令示例
YouTube视频/Shorts/直播yt-dlp "https://www.youtube.com/watch?v=xxx"
TikTok短视频yt-dlp "https://www.tiktok.com/@user/video/xxx"
Twitter/X视频yt-dlp "https://twitter.com/user/status/xxx"
InstagramReels/视频yt-dlp "https://www.instagram.com/reel/xxx"
Facebook视频yt-dlp "https://www.facebook.com/user/videos/xxx"
Reddit视频/直播yt-dlp "https://www.reddit.com/r/subreddit/comments/xxx"
Vimeo视频yt-dlp "https://vimeo.com/xxx"
Twitch直播/录像yt-dlp "https://www.twitch.tv/videos/xxx"

📊 短视频平台

  • 抖音/快手/小红书 - 国内三大短视频平台
  • TikTok - 国际版抖音
  • YouTube Shorts - YouTube短视频
  • Instagram Reels - Instagram短视频

总计支持：1858+ 个平台

工作流程

获取视频链接
    ↓
解析为直链 (curl -sI 获取重定向URL)
    ↓
下载视频 (yt-dlp)
    ↓
提取音频 (ffmpeg)
    ↓
转录为文字 (Whisper)
    ↓
输出文字稿

第一步：解析视频直链

B站短链接解析

# 获取B站直链（BV号）
curl -sI "https://b23.tv/短链接" 2>/dev/null | grep -i location

# 获取完整视频信息（包含cid）
curl -s "https://api.bilibili.com/x/web-interface/view?bvid=BV号"

获取所有视频的BV号

for bv in BV1xxx BV2xxx; do
  echo "=== $bv ==="
  curl -sI "https://b23.tv/短链接" | grep -i location
done

第二步：下载视频

通用下载命令

# 直接下载任意平台视频
yt-dlp -o "/tmp/video.mp4" "视频URL"

# 下载并指定格式
yt-dlp -f "best" -o "/tmp/video.mp4" "视频URL"

各平台下载示例

# B站视频
yt-dlp -o "/tmp/bilibili.mp4" "https://www.bilibili.com/video/BV1xxx"

# YouTube视频
yt-dlp -o "/tmp/youtube.mp4" "https://www.youtube.com/watch?v=xxx"

# YouTube Shorts
yt-dlp -o "/tmp/shorts.mp4" "https://www.youtube.com/shorts/xxx"

# TikTok视频
yt-dlp -o "/tmp/tiktok.mp4" "https://www.tiktok.com/@user/video/xxx"

# 抖音视频
yt-dlp -o "/tmp/douyin.mp4" "https://www.douyin.com/video/xxx"

# 小红书笔记
yt-dlp -o "/tmp/xhs.mp4" "https://www.xiaohongshu.com/explore/xxx"

安装依赖

# yt-dlp 安装
pip3 install yt-dlp

# ffmpeg 安装 (macOS)
brew install ffmpeg

# Whisper 安装
pip3 install -U openai-whisper

下载B站视频

# 下载视频到指定目录
yt-dlp -o "/tmp/video.mp4" "https://www.bilibili.com/video/BV号"

# 下载并自动合并音视频
yt-dlp -f "bv+ba" -o "/tmp/video.mp4" "https://www.bilibili.com/video/BV号"

常用选项

选项说明
-o path输出路径
--cookies-from-browser使用浏览器cookies（会员内容）
-f format指定格式

第三步：提取音频

# 提取 wav 格式（Whisper推荐）
ffmpeg -i /tmp/video.mp4 -vn -acodec pcm_s16le -ar 16000 -ac 1 /tmp/audio.wav -y

# 提取 mp3 格式（体积更小）
ffmpeg -i /tmp/video.mp4 -vn -acodec libmp3lame -ar 16000 -ac 1 /tmp/audio.mp3 -y

第四步：Whisper转录

# 使用base模型（快速）
whisper /tmp/audio.wav --model base --output_format txt --output_dir /tmp

# 使用medium模型（更准确，中文推荐）
whisper /tmp/audio.wav --model medium --output_format txt --output_dir /tmp

# 输出到指定文件
whisper /tmp/audio.wav --model medium --output_format txt --output_dir ~/workspace

模型选择

模型速度准确率适用场景
tiny最快最低快速测试
base快中等一般用途
small中等较高中文推荐
medium慢高重要内容
large最慢最高精度要求极高

Whisper路径

由于安装位置可能不在PATH中，使用完整路径：

# Python 3.9 用户
/Users/yanghaohan/Library/Python/3.9/bin/whisper

# 或添加到PATH
export PATH="/Users/yanghaohan/Library/Python/3.9/bin:$PATH"

第五步：处理结果

转录完成后，文字稿会保存在指定目录的 .txt 文件中。

查看结果：

cat /tmp/audio.txt

完整执行示例

# 1. 解析BV号
BV=$(curl -sI "https://b23.tv/短链接" | grep -i location | grep -oE 'BV[a-zA-Z0-9]+' | head -1)
echo "BV号: $BV"

# 2. 下载视频
yt-dlp -o "/tmp/video.mp4" "https://www.bilibili.com/video/$BV"

# 3. 提取音频
ffmpeg -i /tmp/video.mp4 -vn -acodec pcm_s16le -ar 16000 -ac 1 /tmp/audio.wav -y

# 4. 转录
whisper /tmp/audio.wav --model medium --output_format txt --output_dir /tmp

# 5. 查看结果
cat /tmp/audio.txt

脚本使用

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

# 第一步：下载B站视频并提取音频
~/.openclaw/workspace/skills/video-download/scripts/bilibili-download.sh "b23.tv/xxx" /tmp

# 第二步：转录
~/.openclaw/workspace/skills/video-download/scripts/transcribe.sh /tmp/audio_BVxxx.wav small /tmp

注意事项

  1. B站视频可能没有字幕 - 需要通过Whisper转录
  2. 会员内容 - 需要提供cookies或cookies-from-browser选项
  3. 下载速度 - 取决于网络状况，通常5-10分钟完成一期视频
  4. Whisper模型 - 首次使用会下载模型（约139MB），medium模型需要约3GB磁盘空间

故障排除

yt-dlp下载失败

# 更新到最新版本
pip3 install -U yt-dlp

# 使用cookies（如果有）
yt-dlp --cookies /path/to/cookies.txt "URL"

Whisper模型校验失败

# 删除损坏的模型缓存
rm -rf ~/.cache/whisper/*

# 重新下载
whisper /tmp/audio.wav --model base

Python版本问题

# 检查Python版本
python3 --version

# Whisper需要Python 3.10+
# 如果版本过低，考虑使用Docker或其他环境