Open WebUI 知识库创建教程-龍騰博客

知识库的作用

把你自己写过的心得、总结、发言材料上传后，建立"知识库"。之后提问时用#知识库名引用，模型会先检索相关材料片段作为参考，再结合这些内容生成回复——让AI写东西时更贴近你的措辞习惯和常用框架，而不是泛泛而谈。

进入刚建好的知识库，点击添加文件，支持Word(.docx)、PDF、txt等格式，可以多选批量上传。

默认每次提问只检索3个片段，材料较多时建议调大：

进入管理员设置（左下角头像 → 管理员设置）→ 左侧文档 → 找到Top K，把3改成5或6，滚动到底部保存。

注意： 这个Top K在管理员设置→文档里，不是对话窗口的"高级参数"里那个top_k（那个是采样参数，控制生成时选词范围，跟检索数量无关，两者同名但完全是两件事）。

新建对话，输入#会弹出知识库选择列表，点选对应的知识库（不是直接打字），输入框上方出现引用标签后再输入问题。

关键技巧：问题要带具体素材，不要只说"参考我的风格"。

效果差的问法：

#工作会议材料 帮我写一篇关于本季度风险管理工作的总结，参考我之前的写作风格和常用框架

这种问法模型容易给一个通用模板，甚至反过来问你要细节。

效果好的问法：

#我的写作材料 我们这季度主要完成了：1、XX项制度修订；2、处理XX笔风险事项；3、开展XX次排查。请参考知识库里类似总结的开头写法和小标题结构，写这季度总结的开头部分。

给具体内容，让模型"套框架"，而不是"凭空编"。

回复中如果出现"检索到X个引用来源"，说明RAG生效了。

问题	原因	解决方法
上传.docx报错 `No module named 'docx'`	容器缺python-docx库	`docker exec -it open-webui pip install python-docx --break-system-packages`
上传"成功"但文件没真正进知识库	报错`soffice command was not found`	容器缺LibreOffice，`docker exec -it open-webui bash -c "apt-get update && apt-get install -y libreoffice"`，安装包较大需耐心等待
上传后看不出处理状态	需要进知识库点开文件查看状态	确认显示"已处理"，而不是停留在"处理中"
模型给的是通用模板，没用上素材	提问太抽象（"参考我的风格"）	给具体素材内容，让模型套框架
改了Top K没效果	改的是对话窗口里的采样`top_k`，不是RAG的`Top K`	去管理员设置→文档里改
依赖装完后，容器重启又报错	pip/apt装的库不持久化，容器重建后丢失	一次性把所有文件批量上传完，避免分多次触发同一问题；文件不多的话重装一次即可

如果材料数量多（比如100+篇）且涉及不同场景（风险管理类、党建材料类、人事谈话类等），建议分成多个知识库，提问时按场景用#指定对应的知识库，让检索范围更聚焦，避免不相关内容挤占Top K的位置。