--- name: knowledge description: Unified knowledge capture and retrieval for URLs, video/article/paper extracts, social posts, and agent research outputs. Use when saving anything worth re-finding later, summarizing external content, tracking sourced claims, or answering "where did we store that?" questions. ---

Knowledge Skill

File-based knowledge organization. Capture fast, search later, clean up automatically.

Installation

clawhub install knowledge

This installs scripts/know — add to PATH or use full path:

~/.openclaw/skills/knowledge/scripts/know

Storage Location

Default: ~/.soulshare/agent/knowledge/

Configurable via ~/.config/know/config or env KNOWLEDGE_DIR.

knowledge/
├── INDEX.md      # Auto-maintained browsable index
├── urls/         # Bookmarked URLs
├── extracts/     # Video/article/paper summaries
├── posts/        # Social content (tweets, threads)
└── research/     # Agent-generated research

Adding Content

know add url <url> --title "..." --tags "a,b" [--summary "..."]
know add video <url> --title "..." --tags "a,b" [--summary "..."]
know add extract --source <url> --type video|article|paper --title "..." --tags "a,b"
know add post --source <url> --title "..." --tags "a,b"
know add research --title "..." --tags "a,b" [--summary "..."]

Each add writes a markdown file with YAML frontmatter and updates INDEX.md.

Searching

know search "query"           # Grep across all entries
know recent --limit 10        # Recent entries
know list --tags security     # Filter by tag

Cleanup & Maintenance

know tidy                     # Audit: find issues
know tidy --fix               # Auto-fix: normalize tags, move misplaced files, remove empty
know validate                 # Check frontmatter schema
know reindex                  # Rebuild INDEX.md
know config                   # Show active config paths

Recommended: Run know tidy --fix in heartbeats or nightly cron.

Data Model (frontmatter)

---
type: url|extract|post|research
title: "Entry title"
source_url: "https://..."
source_kind: url|video|article|paper|post|research
tags: ["tag1", "tag2"]
added: "2026-02-26"
added_by: "agent-name"
summary: "One-line summary"
---

QMD Integration

Plain markdown → QMD-indexable.

qmd collection add ~/.soulshare/agent/knowledge --name knowledge
qmd search "query" --collection knowledge

Discipline

• If it's useful later → know add immediately
• Don't leave knowledge only in memory/YYYY-MM-DD.md
• Every entry needs tags + summary
• Let know tidy --fix handle normalization