aionclaw本地知识库可离线实现pdf等文档的自动归类、打标签与精准检索，所有文件保留在本地硬盘。需将支持格式的原始文件统一存入用户文档目录下指定文件夹，路径避免特殊符号；安装工具后新建知识库并关联该文件夹，启用自动更新以完成扫描建索引；首次建库时间依文件量而定，扫描版pdf需预ocr处理；搜索须使用文档内真实连续字串方可返回高亮结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想把散落在电脑各处的PDF报告、会议纪要、产品文档、行业白皮书自动归类、打标签、随时精准检索，又不想上传到任何云端服务器——AionClaw本地知识库功能正好满足这个需求，全部文件始终留在你自己的硬盘里。
准备知识源文件
把你要纳入知识库的所有原始文件（支持PDF、TXT、DOCX、PPTX、XLSX、Markdown）统一整理进一个本地文件夹，比如「我的行业资料库」。不要放在系统盘根目录或需要管理员权限的路径下，【建议放在用户文档目录下，例如 Mac 的 ~/Documents/知识库 或 Windows 的 C:\Users\用户名\Documents\知识库】。这一步看似简单，但若路径含中文括号、&符号或过长层级，后续导入可能静默失败。
确认所有文件能正常双击打开，损坏或加密的PDF无法被解析。
在AionClaw中启用知识库模块
打开AionClaw客户端 → 左侧导航栏点击「工具管理」→ 在「可用工具」列表中找到「本地知识库」→ 点击右侧「安装」按钮。安装过程约15秒，无需重启软件。
安装完成后，该工具会自动出现在左侧导航栏底部，图标为蓝色书本。点击进入，界面顶部显示「知识库未初始化」。
创建并关联本地文件夹
第一步：点击「新建知识库」按钮 → 弹窗中输入名称，例如「财务合规知识库」；
第二步：点击「选择路径」→ 导航至你之前准备好的「我的行业资料库」文件夹 → 确认选择；
第三步：勾选「启用自动更新」→ 点击「确定」。
此时AionClaw开始扫描文件夹内所有文档，提取文本并构建向量索引。首次建库时间取决于文件数量与大小：100份以内PDF约需90秒；若含扫描版PDF（图片型），系统会跳过该文件且不报错，需提前用OCR工具转成可复制文本。
验证与提问测试
扫描完成后，界面右上角状态变为「就绪」，左侧显示已入库文档数量。直接在顶部搜索框输入「增值税留抵退税申报流程」，回车。如果返回3份匹配度最高的PDF文档缩略图，并高亮相关段落，说明知识库已生效。
注意：搜索词必须是文档中真实存在的连续字串，不能过度口语化，比如问「怎么退税？」大概率无结果。
