Link Library — Personal Content Knowledge Base

Save web content with full original text, generate summaries and tags, retrieve semantically.

Core Rules

1. 1. Always save original full text — summaries are for retrieval, originals are for re-reading
2. Detect interest, don't demand commands — if user engages with a link, offer to save
3. Twitter/X is first-class — tweets, threads, and articles are fully supported

Interest Detection

When user shares a link, evaluate interest signals:

Auto-save (no confirmation needed):

• - User explicitly says save/bookmark/记一下/放进知识库
• User asks "帮我总结一下" (summarize implies save-worthy)

Offer to save (ask once):

• - User shares link + positive commentary ("这篇不错", "有意思", "学到了")
• User asks follow-up questions about link content
• User discusses link content substantively

Don't save:

• - User shares link just for quick reference in conversation
• User says "不用保存" or similar

Data Location

All entries in ~/.openclaw/workspace-main/library/:

CODEBLOCK0

Content Types & Fetch Methods

Twitter/X Fetch Details

CODEBLOCK1

Extract from JSON: full_text, user.screen_name, created_at, entities, media URLs.
For threads: concatenate all tweets in order as full content.

Video Subtitle Extraction

CODEBLOCK2

Entry Structure

Every entry has two parts:

1. YAML Frontmatter (structured metadata)

2. Markdown Body (content)

⚠️ MANDATORY: Always save original full text in "Original Content" section.
Summaries and key points are for quick retrieval. The original text is for accurate re-reading and quoting. Never skip saving the full content.

Filename Convention

INLINECODE23

Examples:

• - INLINECODE24
• INLINECODE25
• INLINECODE26

Save Workflow

1. 1. Detect URL — Parse link from user message
2. Identify type — Match URL pattern to content type
3. Check dedup — memory_search("URL or title") to avoid duplicates
4. Fetch content — Use appropriate method from table above
5. Generate metadata — Title, summary, key points, tags (3-7)
6. Write entry — Use template, fill frontmatter + full original text
7. Confirm — Tell user: title, tags, and where it's saved

Search & Retrieval

CODEBLOCK5

When returning search results, show:

• - Title + source + date
• Summary (2 lines max)
• Tags
• Offer to show full original text

Writing Reference Mode

When user asks to write something using saved content:

1. 1. Search library for relevant entries
2. Read full original text of top matches
3. Synthesize insights, cite sources inline
4. Format citations as INLINECODE28

Templates

Located in templates/:

• - article.md — Web articles, blog posts, newsletters
• INLINECODE31 — Twitter/X posts and threads
• INLINECODE32 — Videos with transcript
• INLINECODE33 — Podcast episodes
• INLINECODE34 — Academic papers
• INLINECODE35 — Visual content

Best Practices

• - Save originals religiously — summaries lose nuance
• Tag consistently — reuse existing tags, keep vocabulary tight
• Link related entries — build a knowledge graph over time
• Don't over-ask — if interest is clear, just save and confirm