Назад към всички

knowledge

// 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.

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameknowledge
descriptionUnified 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