openclaw容器需挂载文档路径并启用知识库索引才能读取本地文档。若docker inspect未显示/docs挂载点，须用-v /本地路径:/docs参数重建容器，再在web ui中开启knowledge base并设置document root path为/docs，最后触发rescan documents完成索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地部署后需要让AI能读取你的项目文档、API说明或技术手册，否则它只能凭空编译代码、无法结合真实上下文做决策。文档接入不是把PDF拖进网页就行，必须通过挂载路径+配置识别规则两步完成。
确认OpenClaw容器是否支持文档挂载
打开终端执行：docker inspect openclaw-app | grep -A 5 "Mounts"。如果输出为空或没看到/docs类路径，说明当前容器未预留文档挂载点——这很常见，因为官方默认镜像不强制暴露/docs卷。
必须使用带-v /path/to/your/docs:/docs参数的命令重新启动容器，否则后续所有配置都无效。
将本地文档目录挂载进容器
方法一：基础挂载（适用于纯文本/Markdown文档）
假设你的文档存放在/home/user/myproject/docs，运行以下命令：
docker run -it --rm --pull=always \
-v /home/user/myproject/docs:/docs \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.openclaw-state:/.openclaw-state \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openclaw-app \
此技能为 OpenClaw 安装并配置 Tablestore Mem0 插件。Tablestore Mem0使用阿里云表格存储作为向量存储后端。
docker.openclaw.dev/openclaw:0.41
【/docs是OpenClaw内部约定的文档根目录，不可改成/doc或/documents】
方法二：多级目录映射（适合含子模块的大型文档库）
若文档分散在多个路径，如/docs/api、/docs/spec、/docs/examples，需用逗号分隔写成一行：
-v /home/user/api-docs:/docs/api -v /home/user/spec-v2:/docs/spec -v /home/user/examples:/docs/examples
注意：每个-v参数必须独立存在，不能合并成一个长路径。
在Web UI中启用文档索引功能
第一步：浏览器访问http://localhost:3000 → 点击右上角齿轮图标 → 进入「Agent Settings」
第二步：找到「Knowledge Base」区块 → 开关切换为「Enabled」
第三步：在「Document Root Path」输入框填入/docs → 点击「Rescan Documents」
这一步会触发OpenClaw扫描/docs下所有.md、.txt、.pdf、.html文件并构建向量索引。扫描时间取决于文档总大小，100MB以内通常在20秒内完成。
第四步：返回对话界面，输入“请根据/docs下的API文档，生成调用/user/profile接口的Python示例”，即可验证接入效果。
如果提示“未找到相关文档”，检查容器日志：docker logs openclaw-app 2>&1 | grep -i "indexing\|doc"，常见错误是PDF缺少可提取文本层（扫描版PDF不支持直接解析）。
