前言¶

处理 YouTube 视频内容时，常见的做法是人工看视频记笔记，或者用 yt-dlp 拉字幕再自己整理。前者费时，后者在 VPS、云主机等出口 IP 环境下经常被 YouTube 的云 IP 拦截而失败。下面介绍的 YouTube Summarizer 是一个基于 SKILL.md 的 Agent Skill，它把「检测链接 → 抓文稿 → 生成摘要 → 存档 → 投递」串成一条固定流程，目标是让 Agent 在收到一个 YouTube 链接时，直接输出可读的结构化摘要，并保留可下载的全文文稿。

这是什么¶

YouTube Summarizer 由 abe238（Abe Diaz）发布并维护，坐标 @abe238/youtube-summarizer，上游仓库在 ClawHub，版本 1.0.0，许可证 MIT-0。它属于 knowledge-management 分类，定位是让 Agent 自动获取 YouTube 视频文稿、生成结构化摘要，并把全文文稿发送到消息平台。

SkillHub 页面在抓取时显示评分 100000、下载 13561、安装 279，标签为 requires_api_key=false，即不需要额外配置 API Key。

核心功能¶

官方 SKILL.md 列出的能力如下：

1. 自动识别 YouTube 链接，支持 youtube.com/watch、youtu.be、youtube.com/shorts 以及直接的 11 位视频 ID。
2. 通过 MCP YouTube Transcript server 抓取字幕文稿，拿到标题、频道名、播放量、发布日期、实际语言和分段文本。
3. 按固定模板生成结构化摘要：主论点、关键见解、补充要点、结论。
4. 把完整文稿落盘到带时间戳的文本文件，包含元数据头、全文和原始链接。
5. 按平台投递：Telegram 用 message 命令发送文件，其他/webchat 渠道只回复摘要。
6. 错误处理：文稿抓取失败时检查是否有字幕、尝试语言回退，并给用户替代建议。

安装与启用¶

安装命令来自官方页面，使用 OpenClaw 的 skills CLI：

openclaw skills install @abe238/youtube-summarizer

这个 Skill 有一个前置依赖：MCP YouTube Transcript server 必须已经安装在 /root/clawd/mcp-server-youtube-transcript。如果不存在，按下面步骤安装：

cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build

官方页面还给出了提示词入口：npx skills。整个技能是按 SKILL.md 通用格式编写的，触发条件写在「When to Use」一节：用户分享了 YouTube 链接、用户要求总结或转录某个视频、用户询问某个视频的内容。

官方资料中没有给出 Cursor、Codex CLI、Claude Code 的具体差异说明，这里不做推测。

典型用法¶

官方 SKILL.md 给出的抓取文稿命令如下，把 VIDEO_ID 换成从链接中解析出的视频 ID，结果写入 /tmp/yt-transcript.json：

cd /root/clawd/mcp-server-youtube-transcript && node --input-type=module -e "
import { getSubtitles } from './dist/youtube-fetcher.js';
const result = await getSubtitles({ videoID: 'VIDEO_ID', lang: 'en' });
console.log(JSON.stringify(result, null, 2));
" > /tmp/yt-transcript.json

从返回的 JSON 中按字段取值：result.metadata.title、result.metadata.author、result.metadata.viewCount、result.metadata.publishDate、result.actualLang、result.lines。全文由 result.lines.map(l => l.text).join(' ') 拼出。

摘要模板的结构（官方模板含表情符号，此处只列字段）：

Video: [title]
Channel: [author] | Views: [views] | Published: [date]

Main Thesis: [1-2 句核心观点]
Key Insights: 3-5 条，每条 1-2 句
Notable Points: 2-4 条补充细节
Takeaway: 可执行的结论

官方对篇幅的要求是：主论点 1-2 句，关键见解 3-5 条，补充要点 2-4 条，结论一条。全文文稿保存路径为 /root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt。

投递到 Telegram 时使用：

message --action send --channel telegram --target CHAT_ID \
  --filePath /root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt \
  --caption "YouTube Transcript: [title]"

适用场景与注意¶

适合的场景：需要批量处理 YouTube 视频内容、在云端环境跑自动化、希望 Agent 给出结构化摘要而不是长原文的团队。

需要注意的几点：

1. 依赖 MCP server，环境里没有时整个流程无法启动，需要先按上面的命令安装。
2. 官方说明该 MCP server 使用 Android 客户端模拟来绕过 YouTube 的云 IP 拦截，因此在 VPS/云主机上比 yt-dlp 稳定，但这依赖上游仓库的行为，YouTube 侧策略变化时可能失效。
3. 文稿质量取决于视频本身：自动生成字幕的准确度有限，没有字幕的视频会抓取失败，此时 Skill 只会提示用户改用其他方式。
4. 默认语言是 en，请求的语言不可用时会回退到英文，非英文视频的摘要质量可能受影响。
5. 摘要只做提炼，官方要求不要添加文稿中没有的信息；长视频（超过 30 分钟）需要更细的拆分。
6. 标签写着 requires_api_key=false，但路径、目录名等硬编码在 SKILL.md 里，换目录结构时需要相应调整。

结尾¶

YouTube Summarizer 的价值在于把「抓文稿 + 写摘要 + 存档 + 投递」这条链路固化成 Agent 可复用的流程，减少了人工整理视频内容的时间，也避免了在云环境下用 yt-dlp 反复踩坑。官方地址：https://api.skillhub.cn/org-0ll53pt7/youtube-summarizer ，上游仓库：https://clawhub.ai/abe238/youtube-summarizer 。