---

name: video-subtitle-translator description: 从视频中提取英文字幕并生成中英文双语字幕 metadata: { "openclaw": { "primaryEnv": "OLLAMA_MODEL", "requires": { "env": ["OLLAMA_URL", "OLLAMA_MODEL"] }, "homepage": "https://github.com", }, }

Video Subtitle Translator

功能模块

1. extract - 提取字幕

从视频文件中提取英文字幕，支持 .ass 和 .srt 格式。

2. translate - 翻译字幕

调用 LLM API 将英文字幕翻译为中英文双语格式。

3. embed - 封装字幕（可选）

将双语字幕烧录到视频中。

前置要求

• ffmpeg - 字幕提取和封装
• Python 3.8+ - 翻译脚本运行
• Ollama - 本地 LLM 部署（推荐使用 qwen3:8b 模型）

配置

Ollama（本部署，默认使用）

# 安装 Ollama: https://ollama.com/
# 下载模型
ollama pull qwen3:8b

# 配置环境变量（可选）
export OLLAMA_URL="http://localhost:11434/v1"
export OLLAMA_MODEL="qwen3:8b"

环境变量

# Ollama（默认 - 本地部署，速度快，隐私保护）
export OLLAMA_URL="http://localhost:11434/v1"
export OLLAMA_MODEL="qwen3:8b"

# MiniMax（可选 - 云端 API）
export MINIMAX_API_KEY="your-api-key"
export MINIMAX_API_BASE="https://api.minimax.chat/v1"
export LLM_MODEL="MiniMax-M2.1"

# OpenAI（可选）
export OPENAI_API_KEY="your-api-key"
export LLM_BASE_URL="https://api.openai.com/v1"
export LLM_MODEL="gpt-4o"

# Claude（可选）
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_API_BASE="https://api.anthropic.com/v1"
export LLM_MODEL="claude-sonnet-4-20250514"

可选配置

# 翻译语言对（默认: en→zh）
export SUBTITLE_SOURCE_LANG="en"
export SUBTITLE_TARGET_LANG="zh"

# 批次大小（默认: 10）
export BATCH_SIZE=10

WebUI 配置

在 OpenClaw WebUI 中配置：

• primaryEnv: OLLAMA_MODEL
• requires: env: ["OLLAMA_URL", "OLLAMA_MODEL"]

使用方式

快速翻译（推荐）

cd /Users/pcr/.openclaw/workspace/skills/video-subtitle-translator

# 默认翻译（自动检测断点续翻）
python3 scripts/quick_translate.py subtitle.srt

# 强制全部重新翻译
python3 scripts/quick_translate.py subtitle.srt -f

# 从指定位置开始
python3 scripts/quick_translate.py subtitle.srt -s 50

# 指定批次大小（默认12）
python3 scripts/quick_translate.py subtitle.srt -b 16

# 指定输出文件
python3 scripts/quick_translate.py subtitle.srt -o output.srt

# 记录翻译日志
python3 scripts/quick_translate.py subtitle.srt -l translate.log

方式一：完整流程（提取 + 翻译）

cd /Users/pcr/.openclaw/workspace/skills/video-subtitle-translator

# 提取英文字幕
./scripts/extract_subtitle.sh /path/to/video.mkv

# 使用 Ollama 翻译（默认 - 本地）
./scripts/translate_subtitle.py /path/to/video.en.srt

# 使用 MiniMax 翻译（云端）
./scripts/translate_subtitle.py /path/to/video.en.srt --provider minimax

# 使用 OpenAI 翻译
./scripts/translate_subtitle.py /path/to/video.en.srt --model gpt-4o

# 使用 Claude 翻译
./scripts/translate_subtitle.py /path/to/video.en.srt --provider anthropic

方式二：独立使用各模块

# 仅提取字幕
./scripts/extract_subtitle.sh input.mkv [--format ass|srt]

# 仅翻译字幕（默认使用 Ollama）
./scripts/translate_subtitle.py subtitle.srt

# 指定 provider 翻译
./scripts/translate_subtitle.py subtitle.srt --provider ollama
./scripts/translate_subtitle.py subtitle.srt --provider minimax

# 仅封装字幕到视频
./scripts/embed_subtitle.sh input.mkv subtitle.srt output.mp4

方式三：一条命令执行完整流程

# 使用 Ollama（默认）
./scripts/translate_subtitle.py input.mkv --extract --embed --output output.mp4

# 使用 MiniMax
./scripts/translate_subtitle.py input.mkv --extract --embed --provider minimax --output output.mp4

# 使用 OpenAI
./scripts/translate_subtitle.py input.mkv --extract --embed --output output.mp4

输入输出

extract_subtitle.sh

输入： 视频文件路径

输出：

• video.en.srt - 英文 SRT 字幕
• video.en.ass - 英文 ASS 字幕

translate_subtitle.py

输入： 字幕文件路径（SRT/ASS）

输出：

• 同名 .zh.srt 或 .zh.ass 文件

双语格式：

英文台词
中文翻译

embed_subtitle.sh

输入：

1. 源视频路径
2. 字幕文件路径
3. 输出视频路径（可选）

输出：

• 带字幕的视频文件

快速翻译（推荐）

quick_translate.py - 快速翻译字幕

使用本地 Ollama 快速翻译字幕，支持断点续翻。

cd /Users/pcr/.openclaw/workspace/skills/video-subtitle-translator

# 默认翻译（自动检测断点续翻）
python3 scripts/quick_translate.py subtitle.srt

# 强制全部重新翻译
python3 scripts/quick_translate.py subtitle.srt -f

# 从指定位置开始
python3 scripts/quick_translate.py subtitle.srt -s 50

# 指定批次大小（默认12）
python3 scripts/quick_translate.py subtitle.srt -b 16

# 指定输出文件
python3 scripts/quick_translate.py subtitle.srt -o output.srt

# 记录翻译日志
python3 scripts/quick_translate.py subtitle.srt -l translate.log

参数说明：

• 不带参数：自动检测断点续翻
• -f, --force：强制全部重新翻译
• -s, --start：从指定位置开始
• -o, --output：指定输出文件
• -b, --batch：批次大小（默认12）
• -l, --log：日志文件路径

专有名词修订

subtitles_fixer.py - 专有名词修订工具

翻译完成后，发现专有名词翻译不一致时，可使用此工具进行批量修订。

交互式修订

python3 scripts/subtitles_fixer.py subtitle.zh.srt

仅检索模式（输出对照表）

python3 scripts/subtitles_fixer.py subtitle.zh.srt --search -o glossary.txt

输出的对照表格式：

# 专有名词对照表
# 格式: 英文 => 译文
# = 保留原文

Simon Williams => 西蒙·威廉姆斯
Ruth Bakshi => 露丝·巴克希

批量修订模式

# 基于对照表修订（原地修改）
python3 scripts/subtitles_fixer.py subtitle.zh.srt --fix -g glossary.txt

# 指定输出文件
python3 scripts/subtitles_fixer.py subtitle.zh.srt --fix -g glossary.txt -O output.srt

# 详细模式（显示修改过程）
python3 scripts/subtitles_fixer.py subtitle.zh.srt --fix -g glossary.txt -v

对照表编辑

编辑对照表：

• 保留原文：填写 = 或留空
• 自定义翻译：英文 => 中文译文
• 跳过修改：删除该行

支持的字幕格式

• SRT - SubRip 格式，最通用
• ASS - Advanced Substation Alpha，支持样式

示例

# 完整示例
cd /Users/pcr/.openclaw/workspace/skills/video-subtitle-translator

# 提取字幕
./scripts/extract_subtitle.sh ./test_video.mkv

# 翻译字幕
./scripts/translate_subtitle.py ./test_video.en.srt

# 封装字幕到视频
./scripts/embed_subtitle.sh ./test_video.mkv ./test_video.zh.srt ./test_video_subtitled.mp4

OpenClaw 集成

使用 skill 命令（推荐 ✅）

# 使用 Ollama（默认 - 本地）
openclaw skill run video-subtitle-translator --translate /path/to/video.en.srt

# 使用 MiniMax（云端）
openclaw skill run video-subtitle-translator --translate /path/to/video.en.srt --provider minimax

# 使用 OpenAI
openclaw skill run video-subtitle-translator --translate /path/to/video.en.srt --provider openai

# 完整流程（提取 + 翻译 + 封装）
openclaw skill run video-subtitle-translator --extract --embed /path/to/video.mkv

手动执行（需要手动设置环境变量）

# Ollama 本地部署（默认）
export OLLAMA_MODEL="qwen3:8b"

# 或使用 MiniMax 云端 API
export MINIMAX_API_KEY="your-api-key"

# 运行翻译
cd /Users/pcr/.openclaw/workspace/skills/video-subtitle-translator
python scripts/translate_subtitle.py /path/to/video.en.srt --provider ollama

WebUI 配置

在 OpenClaw WebUI 中配置：

• primaryEnv: OLLAMA_MODEL（使用本地 Ollama）
• requires: env: ["OLLAMA_URL", "OLLAMA_MODEL"]

⚠️ 重要: 使用 openclaw skill run 命令时，WebUI 配置的 API Key 会自动注入。直接 exec 执行脚本则不会。

Ollama 安装配置

1. 安装 Ollama: https://ollama.com/
2. 下载 qwen3:8b 模型：

   ollama pull qwen3:8b
   

3. 启动 Ollama 服务（通常自动启动）：

   ollama serve
   

故障排除

视频没有内嵌字幕

# 检查视频流
ffprobe input.mkv

# 如果有外部独立字幕文件
ffmpeg -i input.mkv -map 0:s:0 subtitle.en.srt

字幕提取失败

• 确认视频中包含字幕流：ffprobe input.mkv | grep Stream
• 使用 -c:s copy 尝试直接复制

翻译 API 错误（Ollama）

• 确认 Ollama 服务正在运行：curl http://localhost:11434/api/tags
• 确认模型已下载：ollama list
• 查看脚本日志获取详细错误信息

翻译 API 错误（云端 API）

• 检查 API 密钥配置
• 确认网络连接到 API 服务
• 查看脚本日志获取详细错误信息