Skills markdown-knowledge

将本地 Markdown 知识库与 OpenClaw 集成，支持语义检索和上下文注入。仅在用户触发时检索（搜索知识库、查一下知识库等），不主动注入。

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/aaronjager92/markdown-knowledge" ~/.claude/skills/clawdbot-skills-markdown-knowledge && rm -rf "$T"

manifest: skills/aaronjager92/markdown-knowledge/SKILL.md

source content

Markdown Knowledge Base

将您的本地 Markdown 知识库与 OpenClaw 集成，让 AI 助手能够基于您的专业知识回答问题。

核心原则

触发式检索 - 仅在用户明确要求时检索知识库，不主动注入。

使用流程

1. 收到用户触发词 → 检索知识库

当用户说以下内容时，调用 search 动作：

"搜索知识库"
"查一下知识库"
"知识库里..."

2. 搜到结果 → 注入上下文并回答

# 调用示例
results = action_search("用户问题关键词")

3. 搜不到结果 → 明确告知

告诉用户"知识库中没有找到相关信息"，然后基于通用知识回答。

命令

命令	说明
`python3 knowledge_base.py build`	构建/更新索引
`python3 knowledge_base.py search <词>`	搜索知识库
`python3 knowledge_base.py stats`	查看统计
`python3 knowledge_base.py init`	初始化配置

安装

clawhub install markdown-knowledge
python3 ~/.openclaw/workspace/skills/markdown-knowledge/scripts/knowledge_base.py init
python3 ~/.openclaw/workspace/skills/markdown-knowledge/scripts/knowledge_base.py build

配置

编辑

~/.openclaw/workspace/skills/markdown-knowledge/config.json

：

{
    "knowledge_path": "~/Knowledge",
    "index_path": "~/.openclaw/workspace/skills/markdown-knowledge/index.json",
    "search_top_k": 3,
    "auto_refresh": false
}

隐私说明

✅ 触发式检索 - 仅用户明确要求时检索
❌ 无全局注入 - 不会主动注入知识库内容
❌ 无后台监听 - 不在后台自动运行

文件结构

markdown-knowledge/
├── SKILL.md
├── clawhub.json            # clawhub 元数据
├── scripts/
│   └── knowledge_base.py   # CLI 入口
├── src/
│   ├── __init__.py
│   ├── config.py           # 配置加载
│   ├── actions.py          # OpenClaw 动作
│   └── knowledge_core.py   # 核心检索逻辑
├── references/
│   └── README.md          # 详细文档
└── assets/