Communitygithub.com

bubble202603/video-subtitle-skill

OpenClaw 技能 — 自動為影片添加中文字幕(類似剪映功能)。使用 JavaScript 管道。

video-subtitle-skill 是什麼?

這個技能自動將影片中的語音轉換為中文字幕並燒錄到影片中,流程類似剪映的自動字幕功能。它透過 Whisper AI(faster-whisper)進行語音辨識以產生英文字幕,接著利用 Google 翻譯 API 自動翻譯成中文,最後使用 FFmpeg 將字幕硬編碼到影片中。此技能支援 MP4、MOV、AVI 等常見格式,並可選擇不同的 Whisper 模型以在準確度與效能之間取得平衡。使用者可透過 OpenClaw 平台直接安裝使用,或手動指定影片路徑與目標語言來執行,適合開發者與內容創作者快速為影片加上繁體或簡體中文字幕。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add bubble202603/video-subtitle-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Video Subtitle Skill

給影片自動添加中文字幕,類似剪映的自動字幕功能。

功能

  • 使用 Whisper AI 識別影片語音並生成英文字幕
  • 自動翻譯成中文字幕
  • 使用 FFmpeg 將字幕燒錄進影片

使用方法

# 基本用法
clawhub install video-subtitle

# 或直接告訴 agent
"給這個影片加上中文字幕"

前置要求

  1. ffmpeg - 必須安裝

    apt-get install -y ffmpeg
    
  2. 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

完整流程

  1. 語音辨識 - 使用 faster-whisper 提取英文字幕
  2. 翻譯 - 使用 Google 翻譯 API 轉成中文
  3. 燒錄 - FFmpeg 將字幕硬編碼進影片

輸出

  • 原影片 + 中文字幕的新影片檔案
  • 同名的 .srt 字幕檔案(可選)

注意事項

  • 影片時長會影響處理時間(語音辨識是瓶頸)
  • 支援 MP4, MOV, AVI 等常見影片格式
  • 預設使用 "base" Whisper 模型(CPU 友善)
  • 如需更準確可使用 "large" 模型(需要更多記憶體)

字幕修正

如果生成的字幕有誤(如專有名詞識別錯誤),可以:

  1. 手動編輯生成的 .srt 檔案
  2. 重新執行燒錄步驟
# 只重新燒錄字幕(不重新識別)
ffmpeg -i input.mp4 -vf "subtitles=corrected.srt" -c:a copy output.mp4

作者: Bubble 🫧
版本: 1.0.0
更新: 2026-03-05

相關技能