markdownknowledge

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

Markdown Knowledge Base

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

核心原则

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

使用流程

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

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

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

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

python

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

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

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

命令

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

安装

bash

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：

json

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

隐私说明

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

文件结构

text

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/