本地知识库检索 Skill（kb-retriever）

适用人群

适合：要整理报告、方案、说明书或演示材料的人、要把零散文档改成更适合交付、汇报或归档版本的人、要先完成第一轮文档整理再交给同事审阅的人。

技能介绍

面向本地知识库目录的检索和问答助手。核心流程：(1)分层索引导航 (2)遇到PDF/Excel时必须先读取references学习处理方法 (3)处理文件后再检索。按文件类型组合使用 grep、Read、pdfplumber、pandas 进行渐进式检索，避免整文件加载。用户问题涉及”从知识库目录回答问题/检索信息/查资料”时使用。

遇到 PDF 或 Excel 文件时的强制检查清单：。

业务背景和落地案例

当团队需要面向本地知识库目录的检索时，可以先用本地知识库检索 Skill（kb-retriever）完成第一轮处理。常见做法是把相关文件、网址、素材或配置交给它，先产出初版结果，再由人工确认和继续推进。

能做什么

• 知识库存放在一个根目录下，包含多种文件类型（如 .md/.txt、.pdf、.xlsx 等），通常按类型或业务用途拆分为多级子目录。
• 采用分层目录索引文件：。
• 根目录有一个 datastructure.md，说明主要的「领域目录」及其用途。
• 每个领域目录下可以有自己的 datastructure.md，说明该目录下有哪些子目录/文件，以及各自用途。
• 更深一层的子目录也可以继续有 datastructure.md，形成多级索引树。
• 知识库根目录约定：。

安装方法

方式 1：对 OpenClaw 说（不用写代码）

适合：OpenClaw、Codex、Kimiclaw、Windsurf、Trae、华为 CodeArts。

直接对 OpenClaw 说：

帮我安装一个叫 本地知识库检索 Skill（kb-retriever） 的 Skill。
如果安装时需要精确名字，就用 skills-kb-retriever。
装好以后，先用它帮我处理一遍当前任务。

如果需要手动安装，可以用这条命令：

clawhub install skills-kb-retriever

方式 2：导入 MD 安装

适合：腾讯Workbuddy、百度Duclaw、字节Arkclaw、智谱Autoclaw、科大讯飞Astronclaw。

1. 找到这条 Skill 自带的 Markdown 文件，通常就是它的 SKILL.md 或同名 .md 文件。
2. 把这个 Markdown 文件导入到你的产品里。
3. 导入完成后，直接对 AI 说：

用刚刚导入的本地知识库检索 Skill（kb-retriever），先帮我处理当前任务。

备注：这一种本质上是导入一个 Markdown 文件，给知道安装包里有 .md 文件的人即可。

方式 3：代码安装

适合：Claude Code、Cursor、通义灵码、文心快码。

这条 Skill 没有整理出稳定的命令行安装写法，建议优先用方式 1 或方式 2。

使用步骤

1. 先选上面 3 种方式里，自己最容易完成的一种。
2. 安装完成后，直接对 OpenClaw 说：“用本地知识库检索 Skill（kb-retriever）帮我处理当前任务。” 先让它自己跑一遍就可以。
3. 如果你已经有明确文件、网址、目录或数据，再把它补给 OpenClaw，让它只处理这一部分。
4. 先看第一轮结果，再决定要不要追加条件、缩小范围或继续执行下一步。
5. 如果这条 Skill 确实好用，就把它保留在常用列表，后面重复任务直接复用。

你需要准备什么

• 与你当前任务相关的文件、网址、目录或数据。
• 要处理的文档、报告或资料文件。
• 希望得到的整理方向或输出格式。
• 需要重点保留或重点修改的部分。
• 如果这条 Skill 依赖外部服务，还要准备对应账号权限或可用凭证。

你会看到什么结果

• 整理后的文档或报告结果。
• 提炼好的重点内容。
• 可继续编辑或交付的材料。

风险提示

• 涉及 API Key、Token 或其他凭证时，先确认保存方式和权限边界。
• 依赖外部服务时，网络波动、配额限制或接口变化都会影响结果。

来源信息

• 公开页面地址: https://agentskillsrepo.com/skill/disrei/skills-kb-retriever
• SKILL.md 下载地址: https://agentskillsrepo.com/skill/disrei/skills-kb-retriever/download