Open CLAW Knowledge Distiller MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
pip install openclaw-knowledge-distiller
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add openclaw-knowledge-distiller -- node "<FULL_PATH_TO_OPENCLAW_KNOWLEDGE_DISTILLER>/dist/index.js"

Replace <FULL_PATH_TO_OPENCLAW_KNOWLEDGE_DISTILLER>/dist/index.js with the actual folder you prepared in step 1.

README.md

Turn YouTube, Bilibili, and Facebook videos into structured knowledge articles

Open CLAW Knowledge Distiller ๐Ÿฆž๐Ÿ“š

้พ™่™พ็Ÿฅ่ฏ†่’ธ้ฆๅ™จ ยท ้พ่ฆ็Ÿฅ่ญ˜่’ธ้คพๅ™จ

English ยท ็น้ซ”ไธญๆ–‡ ยท ็ฎ€ไฝ“ไธญๆ–‡

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:

  1. If the video has subtitles โ†’ extracts them directly (no transcription needed, faster)
  2. If no subtitles โ†’ downloads audio and transcribes locally with Qwen3-ASR MLX on Apple Silicon (no API key, no cloud cost)
  3. 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

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.

Configuration

claude_desktop_config.json
{"mcpServers": {"openclaw-knowledge-distiller": {"command": "kd", "args": ["mcp"]}}}

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.

Frequently Asked Questions

What are the key features of Open CLAW Knowledge Distiller?

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.

What can I use Open CLAW Knowledge Distiller for?

Researchers digesting long lecture or conference videos into structured notes. Students creating concise study guides from educational video content. AI agent users processing video information programmatically for knowledge bases. Finance professionals extracting key insights from market analysis videos.

How do I install Open CLAW Knowledge Distiller?

Install Open CLAW Knowledge Distiller by running: pip install openclaw-knowledge-distiller

What MCP clients work with Open CLAW Knowledge Distiller?

Open CLAW Knowledge Distiller works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Open CLAW Knowledge Distiller docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare