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/