video-link-notes

简体中文 | English

video-link-notes 是一个可直接给 OpenClaw 使用的 skill，也是一套可独立运行的“视频链接转 Markdown 笔记”工具链。

它的设计目标有两个：

• 作为独立项目，本地完成 transcript-first 的视频笔记整理
• 作为 OpenClaw skill，保留 SKILL.md + scripts/ 结构，拿到手就能接进 OpenClaw

核心特性

• 支持 Bilibili、YouTube、抖音、快手等视频链接
• 优先提取字幕，失败后回退到音频下载和本地转写
• 输出 Markdown 笔记、摘要、关键观点、行动项
• 没有模型 key 也能工作，会返回保底的启发式笔记
• 用户自己提供模型 key 后，可以得到更好的总结质量
• secrets 和本地状态文件都放在仓库外，不跟代码一起提交

仓库结构

这个仓库根目录本身就是 skill 目录。

给 OpenClaw 用的时候，下面两项必须保持在同一个目录里：

• SKILL.md
• scripts/

安装到 OpenClaw

如果你的 OpenClaw skills 目录是 ~/.openclaw/skills，可以这样安装：

ln -s /absolute/path/to/video-link-notes ~/.openclaw/skills/video-link-notes

或者直接复制：

cp -R /absolute/path/to/video-link-notes ~/.openclaw/skills/video-link-notes

本地依赖

• node
• pnpm
• python3
• yt-dlp
• ffmpeg

安装 Node 依赖：

pnpm install

可选：安装本地 ASR：

bash scripts/setup_local_asr.sh mlx-whisper

或者：

bash scripts/setup_local_asr.sh faster-whisper

快速开始

直接生成公开视频笔记：

bash scripts/generate_note.sh --url "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

只看 transcript JSON：

bash scripts/resolve_transcript.sh --url "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --json

敏感信息与用户自备配置

这个仓库不会内置任何真实 secrets。

以下内容必须由用户自己准备，且不能提交进仓库：

• cookies 文件
• 模型 key
• API key
• token
• .env
• 本地缓存
• 临时音频和转写输出

Bilibili cookies

对于 Bilibili，很多情况下需要用户自己提供 Netscape 格式的 cookies.txt：

bash scripts/generate_note.sh --url "<bilibili_url>" --cookies-file /path/to/cookies.txt

也可以把它放在本地默认位置：

~/.openclaw/bilibili.cookies.txt

模型 key

模型增强总结是可选的，不是必须项。

即使没有模型 key，项目也会返回保底笔记。

MiniMax 示例：

export MINIMAX_API_KEY="your_api_key_here"

或者放到本地文件里：

~/.openclaw/minimax.key

仓库里绝对不要提交真实 cookies、key、cookie_id、token 或其他私有状态文件。

MiniMax Coding Plan 优惠

如果你准备启用 MiniMax 做增强总结，可以扫描下方海报二维码领取 MiniMax Coding Plan 九折订阅优惠。

活动时间： 2025-12-26 到 2026-04-30

兼容性说明

这个仓库是从 bilinote 独立拆出来的。

为了不打断已有环境，v1 里内部环境变量前缀仍然保留为 BILINOTE_*。这是兼容设计，不代表你还需要旧仓库。

烟雾测试

脚本语法检查：

pnpm run smoke:syntax

本地 fixture 合成测试：

pnpm run smoke:synth

YouTube 烟雾测试：

pnpm run smoke:youtube

如果要换测试链接：

YOUTUBE_TEST_URL="https://www.youtube.com/watch?v=dQw4w9WgXcQ" pnpm run smoke:youtube

如果本地还没装 ASR，YouTube 烟雾测试可能会返回 audio-download-only 的保底笔记，这是符合预期的最小可用路径。

常见问题

• yt-dlp not found 先安装 yt-dlp
• ffmpeg 缺失 先安装 ffmpeg
• Bilibili 返回 HTTP 412 说明需要用户自己提供 cookies
• 没有本地转写后端 安装 mlx-whisper、faster-whisper 或 whisper
• 没有模型 key 项目仍可运行，只是只能走保底笔记生成