---

name: youtube-to-chinese description: 将 YouTube 视频转成中文稿，包含完整中文转录、内容摘要和核心亮点。当用户提供 YouTube 链接并要求转录、翻译、生成中文稿、摘要或笔记时触发。Trigger phrases: YouTube转中文, 视频转文字, 转录视频, 生成中文笔记, 视频摘要, youtube transcript chinese.

YouTube → 中文稿

将 YouTube 视频音频下载后，用 AI 转录并整理为结构化中文输出。

工作流程

第一步：下载音频

bash <skill_dir>/scripts/download_audio.sh "<YouTube_URL>" /tmp/yt-audio

脚本输出文件路径（stdout），失败时输出错误说明（stderr）并退出非零码。

可选参数：

• 第 3 参数传 cookies 文件路径（/path/to/cookies.txt）或 browser:chrome（从 Chrome 读取 cookies）
• 若遇到 bot 检测错误，见下方「常见问题」

第二步：AI 转录

用 audios_understand 工具转录音频文件：

audios_understand([{
  "file": "<第一步输出的文件路径>",
  "prompt": "请完整转录这段音频的所有内容，保留说话者的原意，不要遗漏任何部分。输出语言为中文。"
}])

注意： audios_understand 是 OpenClaw 内置工具，直接传本地文件路径即可，无需上传。

第三步：整理输出

拿到转录文本后，整理为以下格式：

---

📝 完整中文稿

逐段输出，每段保留自然段落结构，确保语义完整、表达流畅（可适当润色，但不改变原意）。

---

📋 内容摘要

3-5 句话概括视频核心内容，包括主题、主要观点和结论。

---

✨ 核心亮点

• 亮点 1
• 亮点 2
• 亮点 3
• ...（5-8 条，每条一句话）

---

常见问题

YouTube 下载失败（bot 检测 / 地区限制）

1. 更新 yt-dlp：curl -sL https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /tmp/yt-dlp && chmod +x /tmp/yt-dlp
2. 用浏览器 cookies：在第 3 参数传 browser:chrome（需在有 YouTube 登录状态的机器上运行）
3. 导出 cookies 文件：在 Chrome 安装 Get cookies.txt LOCALLY 扩展，导出后传路径

视频过长（> 2小时）

audios_understand 对超长音频可能截断。建议：

• 优先处理 < 60 分钟的视频
• 超长视频可用 ffmpeg 分段：ffmpeg -i input.mp3 -t 3600 -c copy part1.mp3

音频文件清理

处理完成后删除临时文件：rm -rf /tmp/yt-audio /tmp/yt-test