| name | markdown-knowledge |
| description | 将本地 Markdown 知识库与 OpenClaw 集成，支持语义检索和上下文注入。仅在用户触发时检索（搜索知识库、查一下知识库等），不主动注入。 |
| description_zh | 将本地 Markdown 知识库与 OpenClaw 集成，支持语义检索和上下文注入。仅在用户触发时检索，不主动注入。 |
| author | aaronjager92 |
| version | 1.1.1 |
| license | MIT |
| homepage | null |
| tags | ["markdown-knowledge","markdown","retrieval","productivity"] |
| defaults | {"knowledge_path":"~/Knowledge","index_path":"~/.openclaw/skills/markdown-knowledge/index.json","search_top_k":3,"auto_refresh":false} |
| triggers | [{"action":"search","description":"检索知识库相关内容","patterns":["搜索知识库","查一下知识库","知识库里","查知识库","知识库搜索","知识库查询"]},{"action":"rebuild","description":"重建知识库索引","patterns":["刷新知识库","更新知识库","重建知识库","刷新知识库索引","更新知识库索引","重建知识库索引"]},{"action":"stats","description":"查看知识库统计","patterns":["知识库统计","查看知识库","知识库状态"]}] |
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/skills/markdown-knowledge/scripts/knowledge_base.py init
python3 ~/.openclaw/skills/markdown-knowledge/scripts/knowledge_base.py build
配置
编辑 ~/.openclaw/skills/markdown-knowledge/config.json：
{
"knowledge_path": "~/Knowledge",
"index_path": "~/.openclaw/skills/markdown-knowledge/index.json",
"search_top_k": 3,
"auto_refresh": false
}
隐私说明
- ✅ 触发式检索 - 仅用户明确要求时检索
- ❌ 无全局注入 - 不会主动注入知识库内容
- ❌ 无后台监听 - 不在后台自动运行
