openclaw/video-transcribe-v1-0-3

Video Transcribe - 视频转文字

🎬 一键转录本地视频/音频为文字稿

使用 OpenAI Whisper 进行本地语音识别，完全免费、离线运行、保护隐私。

---

✨ 功能特点

• ✅ 完全免费 - 无需 API 密钥，无使用限制
• ✅ 本地运行 - 视频不上传，保护隐私
• ✅ 支持多格式 - mp4, mov, avi, mkv, mp3, wav, m4a 等
• ✅ 自动语言检测 - 支持中文、英文等 90+ 语言
• ✅ 带时间戳 - 输出 SRT 字幕格式
• ✅ 多模型选择 - 从快速到高精度任选
• ✅ AI 内容总结 - 转录后自动生成 200-300 字摘要 + 关键要点

---

📦 安装依赖

v1.0.3+ 无需手动安装！ 首次运行时会自动检测并安装 Whisper 引擎（约 300MB，一次性）。

如果自动安装失败，可手动安装：

pip3 install openai-whisper -i https://pypi.tuna.tsinghua.edu.cn/simple

💡 安装大小：约 200-300 MB ⏱️ 安装时间：5-10 分钟（首次需下载模型）

---

🚀 使用方法

方式 1：直接用命令

# 基础用法（自动检测语言）
python transcribe.py /path/to/video.mp4

# 指定中文
python transcribe.py /path/to/video.mp4 base zh

# 转录 + AI 总结
python transcribe.py /path/to/video.mp4 --summarize

# 输出到指定目录 + 总结
python transcribe.py /path/to/video.mp4 base zh --summarize

方式 2：在 OpenClaw 中调用

/transcribe /path/to/video.mp4 --summarize

---

📁 输出文件

转录完成后会生成以下文件（在同一目录）：

| 文件 | 格式 | 说明 | |------|------|------| | 视频名.txt | 纯文本 | 无时间戳的文字稿 | | 视频名.srt | SRT 字幕 | 带时间戳，可导入剪映/PR | | 视频名.vtt | WebVTT | 网页字幕格式 | | 视频名_summary.json | JSON | AI 内容总结（使用 --summarize 时生成） |

---

🔧 高级选项

# 只输出文字，不生成字幕
whisper video.mp4 --output_format txt

# 指定输出语言（翻译为英文）
whisper video.mp4 --task translate

# 调整温度（越高越随机，0 最确定）
whisper video.mp4 --temperature 0

# 显示详细日志
whisper video.mp4 --verbose True

完整选项：whisper --help

---

📝 注意事项

1. 首次运行会下载模型（一次性，约 100-800 MB）
2. 视频文件路径不要有空格，或用引号括起来
3. 长视频需要耐心等待（5 分钟视频约 5-10 分钟转录时间）
4. 背景噪音会影响准确率，安静环境效果更好

---

🙏 致谢

• 核心引擎：OpenAI Whisper
• 开源协议：MIT

---

📮 反馈

遇到问题或有建议？欢迎反馈！

作者： Seven
版本： 1.0.3
更新时间： 2026-03-18

---

📋 更新日志

v1.0.3 (2026-03-18)

• ✨ 新增：首次运行时自动安装 Whisper 依赖，无需手动执行 pip 命令
• 🔧 优化：使用清华镜像源自动安装，国内用户更快
• 📝 更新：SKILL.md 说明文档，告知用户自动安装行为

v1.0.2 (2026-03-16)

• 🐛 修复：添加 YAML front matter 到 SKILL.md，修复技能在 OpenClaw 中无法显示的问题
• 📦 更新元数据格式，确保与 ClawHub 规范兼容

v1.0.0 (2026-03-13)

• ✨ 初始版本发布
• 🎬 支持本地视频/音频转录
• 🤖 集成 OpenAI Whisper 引擎
• 📄 输出 TXT 和 SRT 格式
• 📊 支持 AI 内容总结