LinkDigest YouTube 摘要

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install linkdigest-youtube-summary
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 linkdigest-youtube-summary。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

LinkDigest YouTube Summary 是一款 Openclaw Skills 工具，可帮助你无需完整观看视频便了解 YouTube 视频内容。提交标准 YouTube、youtu.be 或 Shorts 链接，即可获取带时间戳的转录片段、要点以及屏幕上识别到的文字，包括幻灯片文字、代码和图表标签等内容。即使视频没有字幕，它也能进行分析，因为模型会同时读取视频中的语音和画面。
你可以利用结果创建简明摘要、按时间戳定位主题，或将教程整理成笔记。添加翻译选项即可获得中文输出，也可以请求 JSON，以便用于结构化工作流程。该技能会将视频链接发送至 LinkDigest API；它不会使用你的 Google 账号、下载视频或写入本地文件。API 按积分计费，费用取决于视频长度和是否选择翻译。

应用场景

总结 YouTube 视频，或在决定是否观看前了解视频内容。
获取带时间戳的转录文本，并跳转到讨论特定主题的片段。 --translate-to zh-CN 将转录文本和要点翻译成简体中文。
ocr_text
提取演示文稿、代码示例、图表或其他视频画面中显示的文字。
利用按时间顺序排列的要点和转录文本，将外语教程整理成笔记。
请求结构化 JSON 输出，用于后续处理或集成。 --max-credits 设置积分上限，在处理前检查预估用量。

工作原理

用户提供 YouTube、youtu.be 或 Shorts 链接，并请求摘要、转录文本、翻译或屏幕文字。
该技能使用已配置的 LINKDIGEST_API_KEY 运行 LinkDigest 脚本，并将链接提交至 LinkDigest。
LinkDigest 分析视频中的语音内容和画面文字，包括没有字幕的视频，并返回带时间戳的转录片段、要点和 OCR 文字。
如果用户提出请求，脚本会添加翻译后的标题、要点和转录内容，同时保留原文并附上译文。
智能体呈现相关结果：摘要使用 key_points，定位具体时刻使用 transcript，查看画面可见文字使用 ocr_text。
智能体报告积分用量和任何内容覆盖限制。如果长时间运行的任务尚未完成，应使用其任务 ID 继续获取结果，而不是再次提交视频。

配置指南

在 https://linkdigest.dev/app/keys 创建 LinkDigest API 密钥。新账号会获得 10 个积分。
在环境变量或技能的 OpenClaw env 配置中设置密钥。密钥以 ld_live_ 开头。
确保已安装 python3 和 curl。
使用 YouTube URL 运行脚本：
export LINKDIGEST_API_KEY=ld_live_...
python3 {baseDir}/scripts/linkdigest.py "https://www.youtube.com/watch?v=xxxxxxxxxxx"
根据需要添加选项。例如，将结果翻译成简体中文或请求 JSON：
python3 {baseDir}/scripts/linkdigest.py "https://www.youtube.com/watch?v=xxxxxxxxxxx" --translate-to zh-CN --format json
使用 --max-credits N，可在预估费用超过所选上限时停止处理。对于待处理的长视频任务，使用 --job-id 获取结果，无需再次提交视频。脚本成功时返回退出代码 0；代码 3 表示密钥无效，代码 4 表示积分不足或视频超过账号限制，代码 5 表示无法读取视频，代码 7 表示仍在处理中。请访问 https://linkdigest.dev/zh/docs 查看最新文档和账号详情。
LinkDigest YouTube 摘要 数据架构与分类体系
脚本默认输出 Markdown。需要结构化输出时，请使用 --format json。
字段 内容
title 视频标题。
author 频道或创作者名称。
transcript[] {t, text} 格式的带时间戳转录片段；t 以秒为单位。
ocr_text[] 在视频画面中检测到的文字。
key_points[] 主要要点；可通过 key_point_support 查看支持要点的转录引文。
translation 可选的标题、要点和转录文本译文；使用 --translate-to 时返回，并附带原文。
coverage 已读取的视频内容范围，以及未覆盖的部分。
credits 此请求消耗的积分。
cached 结果是否来自缓存。
该技能不会写入文件。LinkDigest 会按链接缓存文本结果，因此之前处理过的视频可能不消耗积分。返回的数据不包含视频简介和上传日期；如有需要，请让用户直接提供简介链接。转录文本中的姓名和数字等细节可能有误，请对照原视频核实重要信息。

高级特性

画面与语音分析：
同时读取语音内容和屏幕文字，因此分析视频不需要字幕。
按时间戳检索：
转录条目包含秒数，便于定位和引用特定时刻。
关联证据的要点：
要点包含支持它们的转录引文，可通过
key_point_support
获取。
翻译： --translate-to zh-CN 可请求标题、要点和转录文本的中文翻译，额外消耗 1 个积分。
费用控制：
如果将超过积分上限， --max-credits N 会阻止处理。用量根据视频时长计算；缓存结果不消耗积分。
长时间运行的任务： --job-id 可继续获取进行中的结果，而无需再次提交同一视频。
机器可读输出： --format json

工作原理

运行边界：
脚本只读取
LINKDIGEST_API_KEY
，连接至
linkdigest.dev
，不会下载视频或写入本地文件。私人、已删除、受年龄限制和仅限会员观看的视频可能无法访问；该服务还限制每小时最多调用 60 次。

name: linkdigest-youtube-summary description: "YouTube 视频总结和字幕提取，带时间戳，可直接译成中文。用户发来 YouTube 链接（youtube.com、youtu.be、Shorts），要中文总结、要点、逐字稿、字幕、画面上的文字，或者想不看视频先知道讲了什么时使用。没有字幕的视频也能读：由模型直接看视频，口播和画面文字一起出。不需要梯子抓字幕、不需要 yt-dlp、不需要 Cookie。通过 LinkDigest API 读取，需要 LINKDIGEST_API_KEY，按分钟计费，注册送 10 积分。" version: 1.0.0
homepage: https://linkdigest.dev/zh/docs