1
Add it to Claude Code
claude mcp add openclaw-knowledge-distiller -- kd mcp2
Make your agent remember this setup
openclaw-knowledge-distiller's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Local ASR transcription using Qwen3-ASR MLX on Apple Silicon
- Automatic subtitle detection to skip transcription when possible
- Supports 8 distinct summary styles including academic, investment, and ELI5
- Multi-provider AI summarization support (Google, OpenAI, Anthropic)
- Zero API key mode for pure local transcription
Tools 2
process_videoProcesses a video URL to extract subtitles or transcribe audio and generate a structured summary.list_stylesLists all available summary styles for knowledge articles.Environment Variables
API_KEYAPI key for the chosen AI provider (Google, OpenAI, or Anthropic) if summarization is enabled.Try it
→Process this YouTube video URL and generate an academic summary.
→Summarize the video at this link using the investment analysis style.
→Transcribe this Bilibili video locally without using an AI summary provider.
→List all available summary styles I can use for my video notes.
Original README from destinyfrancis/openclaw-knowledge-distiller
Open CLAW Knowledge Distiller 🦞📚
龙虾知识蒸馏器 · 龍蝦知識蒸餾器
Turn YouTube, Bilibili, and Facebook videos into structured knowledge articles in seconds — locally, for free. 秒速将 YouTube、Bilibili、Facebook 视频转化为结构化知识文章 — 本地运行，完全免费。
English
What is Open CLAW Knowledge Distiller?
Open CLAW Knowledge Distiller（龍蝦知識蒸餾器，kd）is an open-source CLI tool and MCP server built for the Open CLAW AI agent ecosystem. It converts YouTube, Bilibili, and Facebook videos into structured knowledge articles — automatically, locally, and for free.
How it works:
- If the video has subtitles → extracts them directly (no transcription needed, faster)
- If no subtitles → downloads audio and transcribes locally with Qwen3-ASR MLX on Apple Silicon (no API key, no cloud cost)
- Optionally generates a multi-layer AI summary: one-sentence essence + key points + cleaned transcript
Who is it for?
- Researchers and students who need to digest hours of video content quickly
- AI agent users (Claude Code / Open CLAW 龍蝦) who want to process videos programmatically
- Anyone who wants structured notes from videos without watching them in full
Features
| Feature | Details |
|---|---|
| 🎙️ Local ASR | Qwen3-ASR MLX runs entirely on-device (Apple Silicon). No API key, no cloud, free forever. |
| 📝 Smart subtitle detection | Auto-detects existing subtitles — skips ASR for faster processing |
| 🤖 AI summarization | Supports Google Gemini, OpenAI, and Anthropic as summary providers |
| 🎨 8 summary styles | Standard, Academic, Action List, News Brief, Investment Analysis, Podcast Digest, ELI5, Bullet Notes |
| 🔌 MCP Server | Connect from Claude Code, Open CLAW, or any MCP-compatible AI agent |
| 🌏 Multilingual | Cantonese (粵語), Mandarin, English, Japanese, Korean, and 50+ languages |
| ⚡ Zero API key mode | --no-summary: pure local transcription, no external services needed |
Installation
Prerequisites:
brew install ffmpeg # audio extraction
Install:
pip install openclaw-knowledge-distiller
# or with uv:
uv add openclaw-knowledge-distiller
Qwen3-ASR model (~1-2 GB) downloads automatically from Hugging Face on first use.
Install from source (for development):
git clone https://github.com/destinyfrancis/openclaw-knowledge-distiller.git
cd openclaw-knowledge-distiller
uv sync
Quick Start
# ── No API key needed (100% local) ────────────────────────────────
kd process "https://youtube.com/watch?v=dQw4w9WgXcQ" --no-summary
# Cantonese video with dialect hint
kd process "https://youtube.com/watch?v=..." \
--language yue \
--asr-prompt "這是粵語口語對話，請保留懶音" \
--no-summary
# ── With AI summary ────────────────────────────────────────────────
kd config set api-key "AIzaSy..." # Google Gemini (default provider)
kd process "https://youtube.com/watch?v=..."
# Save as Markdown file
kd process "https://youtube.com/watch?v=..." --output notes.md
# ── Choose a summary style ─────────────────────────────────────────
kd process "https://youtube.com/watch?v=..." --style investment
kd process "https://youtube.com/watch?v=..." --style academic
kd process "https://youtube.com/watch?v=..." --style podcast
kd process "https://youtube.com/watch?v=..." --style eli5
# List all available styles
kd styles
# ── Other AI providers ─────────────────────────────────────────────
kd process "..." --provider openai --model gpt-4o-mini
kd process "..." --provider anthropic --model claude-haiku-4-5-20251001
Summary Styles
Run kd styles to list all styles. Choose with --style <key>:
| Key | Name | Best For | |
|---|---|---|---|
standard |
📋 | Standard Summary | General videos (default) |
academic |
🎓 | Academic Notes | Lectures, research talks, conference papers |
actions |
✅ | Action List | Tutorials, how-to guides, step-by-step videos |
news |
📰 | News Brief | Interviews, current events, news commentary |
investment |
📈 | Investment Analysis | Finance, stocks, crypto, macro economics |
podcast |
🎙️ | Podcast Digest | Conversations, talk shows, Q&A sessions |
eli5 |
🧒 | Explain Like I'm 5 | Tech, science, academic topics for a general audience |
bullets |
⚡ | Bullet Notes | Ultra-concise, fast scanning, quick reference |
CLI Reference
`kd process `
Full pipeline: detect subtitles → transcribe (if needed) → summarize.
| Flag | Default | Description |
|---|---|---|
--language, -l |
auto-detect | Language code: zh, yue (Cantonese), en, ja, ko… |
--style, -s |
standard |
Summary style preset (run kd styles to list all) |
--provider, -p |
google |
AI provider: google | openai | anthropic |
--model, -m |
provider default | AI model name (e.g. gemini-2.5-flash, `gpt-4o-min |