Video Subtitle Skill
給影片自動添加中文字幕,類似剪映的自動字幕功能。
功能
- 使用 Whisper AI 識別影片語音並生成英文字幕
- 自動翻譯成中文字幕
- 使用 FFmpeg 將字幕燒錄進影片
使用方法
# 基本用法
clawhub install video-subtitle
# 或直接告訴 agent
"給這個影片加上中文字幕"
前置要求
-
ffmpeg - 必須安裝
apt-get install -y ffmpeg -
Python 環境 - 需要以下套件:
pip install faster-whisper translators
命令列用法
# 給影片加字幕
node /root/.openclaw/workspace/skills/video-subtitle/add-subtitle.js <影片路徑> [目標語言]
# 範例
node add-subtitle.js /path/to/video.mp4 zh
完整流程
- 語音辨識 - 使用 faster-whisper 提取英文字幕
- 翻譯 - 使用 Google 翻譯 API 轉成中文
- 燒錄 - FFmpeg 將字幕硬編碼進影片
輸出
- 原影片 + 中文字幕的新影片檔案
- 同名的 .srt 字幕檔案(可選)
注意事項
- 影片時長會影響處理時間(語音辨識是瓶頸)
- 支援 MP4, MOV, AVI 等常見影片格式
- 預設使用 "base" Whisper 模型(CPU 友善)
- 如需更準確可使用 "large" 模型(需要更多記憶體)
字幕修正
如果生成的字幕有誤(如專有名詞識別錯誤),可以:
- 手動編輯生成的 .srt 檔案
- 重新執行燒錄步驟
# 只重新燒錄字幕(不重新識別)
ffmpeg -i input.mp4 -vf "subtitles=corrected.srt" -c:a copy output.mp4
作者: Bubble 🫧
版本: 1.0.0
更新: 2026-03-05