若要在OpenClaw中创建个人知识库,您需要先登录账号并确保具备「知识库管理」权限,接着准备好符合格式与大小要求的文档,最后通过新建、上传、解析和启用四个步骤完成操作。
前提条件与权限要求
- 确保您已登录OpenClaw账号,且该账号拥有「知识库管理」权限,否则「新建知识库」按钮将无法显示或点击无反应。
准备本地知识文档
- 支持的文档格式:TXT、PDF、DOCX、MD、CSV、XLSX。
- 单个文件大小不得超过100MB,PDF文档须为可复制文字的版本(扫描版PDF无法提取文本)。
- 请将所有文件放入同一个空文件夹的根目录,避免嵌套子文件夹——OpenClaw会忽略子目录,仅读取根目录下的文件。

新建知识库
- 启动OpenClaw,点击左侧导航栏中的【知识库】。
- 点击右上角的【+ 新建知识库】按钮。
- 在弹出的窗口中输入知识库名称(例如“产品FAQ_v2”),并可选择分类标签,填写完毕后点击【下一步】。注意:若未填写名称,按钮将变为灰色且无任何提示,必须填写名称才能继续上传。
小提示:若已有知识库需要更新,建议先删除旧库再新建,以免名称冲突。
上传文档并解析
提供了以下两种上传方式:
- 拖拽上传:直接将整个文件夹拖入虚线框内,松开鼠标后自动开始上传。
- 手动选择文件:点击虚线框内的【点击选择文件】按钮,在系统弹窗中按住Ctrl(Windows)或Command(Mac)键多选文件,确认后上传。
上传完成后,系统将自动启动文本解析与向量化处理。PDF和DOCX格式的文档可能需要30秒到2分钟,在此期间页面会显示“处理中”状态。请勿关闭页面或刷新浏览器,否则解析将中断且进度无法恢复。
启用知识库
- 解析完成后,状态栏会显示“就绪”,右侧会出现【启用】按钮。
- 点击【启用】,等待状态变为绿色“已启用”。
- 此时该知识库将出现在聊天界面的知识源下拉菜单中,即可立即用于提问。
注意:启用后无法重命名知识库名称。如需修改名称,必须先停用,再删除,然后重新创建。
常见问题解答
- Q:上传后解析一直未完成怎么办?
首先检查文件是否过大(单个超过100MB)或PDF是否为扫描版。若等待超过5分钟仍无变化,请刷新页面后重新上传。 - Q:为什么上传后状态显示“失败”?
可能原因包括:文件格式不支持、文件损坏、或网络连接中断。建议逐一测试文件,排除问题后重新上传。 - Q:知识库启用后,如何删除?
进入【知识库】列表,找到该知识库,点击右侧的操作按钮(如“停用”或“删除”),先停用再删除即可。
完成以上步骤后,您就可以在OpenClaw中正常使用个人知识库,并在对话中引用相关文档内容。
