Agent Knowledge Capture

通过 know 命令行把 URL、视频/文章/论文摘要、社交帖子和调研记录保存为带 YAML frontmatter 的 markdown 文件，支持关键词搜索、标签筛选、最近条目查看、frontmatter 校验与 tidy 自动整理，并持续维护可浏览的 INDEX.md，另可选接入 QMD 做索引检索。

ianderrington

热度 97.36

最近更新 2026-05-17 12:52:21

分类：知识依赖：代码执行 / 读写文件应用场景：笔记整理 / 研究 / 工作流 / 摘要总结

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add agent-knowledge

Metadata

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