QMD
搜索 搜索与效率工具安装命令
npx clawhub@latest install qmd
安装说明
1
确认环境
确保已安装 Node.js 22+ 和 OpenClaw。在终端运行 openclaw --version 确认 OpenClaw 正常工作。
2
执行安装
在终端中运行上方安装命令,ClawHub 会自动下载并安装 QMD 到 ~/.openclaw/skills/ 目录。
3
验证安装
运行 openclaw skills list 查看已安装技能列表,确认 QMD 已出现在列表中。
4
配置参数(可选)
根据下方介绍中的配置说明,在 ~/.config/openclaw/openclaw.json5 中添加技能的配置项。
手动安装方式:将 Skill 文件夹复制到
~/.openclaw/skills/ 或项目目录下的 skills/ 文件夹,确保文件夹中包含 SKILL.md 文件。
本地索引
向量检索
MCP 模式
详细介绍
QMD 是一个高性能的本地搜索索引工具,结合 BM25 关键词匹配、向量语义检索和重排序技术,提供精准的本地文档搜索能力。
核心功能
- BM25 检索:经典关键词匹配算法,精准匹配文档
- 向量检索:基于嵌入模型的语义搜索,理解查询意图
- 混合排序:BM25 + 向量的混合检索结果重排序
- MCP 模式:支持作为 MCP 服务器运行,与其他工具集成
- 增量索引:支持文档变更时的增量索引更新
安装
clawhub install qmd
配置参数
{
skills: {
qmd: {
indexDir: ".openclaw/qmd-index", // 索引存储目录
embeddingModel: "bge-small", // 嵌入模型
mcpMode: false, // 是否启用 MCP 模式
chunkSize: 512 // 文档分块大小
}
}
}
使用提示
- 首次使用需要对文档目录建立索引:
openclaw qmd index ./docs - 向量检索需要下载嵌入模型,首次使用会自动下载
- MCP 模式下可被其他 AI 工具作为搜索后端调用