OpenClaw需通过挂载本地资料目录至Docker容器并显式调用Read/Glob等工具读取预处理后的UTF-8文本文件，路径必须严格一致，非文本文件须提前转为文本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让OpenClaw中的AI读取已有资料，核心是把本地文件或结构化知识注入其上下文感知系统，而不是依赖模型自身记忆。OpenClaw本身不直接处理文档加载，它依赖底层Agent Harness（如OpenHarness）提供的Read、Glob、WebFetch等工具链完成资料接入。
准备资料并挂载到容器内
OpenClaw运行在Docker容器中，AI无法直接访问宿主机文件系统。必须将资料目录显式挂载进容器，否则所有读取操作都会失败。
启动容器时，在 docker run 命令末尾添加挂载参数：-v /path/to/your/docs:/workspace/docs:ro。其中 /path/to/your/docs 是你本地存放PDF、Markdown、CSV等资料的绝对路径；/workspace/docs 是容器内统一访问路径；:ro 表示只读，防止AI误删原始资料。
【必须确保挂载路径与后续工具调用路径完全一致】。例如你在提示词里写“读取/workspace/docs/api_spec.md”，但挂载的是 -v ~/data:/docs，则读取必然报错。
在提示词中触发资料读取动作
OpenClaw不支持自动扫描目录或隐式索引。你需要在用户输入中明确指令AI调用工具读取指定文件。
方法一：直接指明文件路径+格式要求
输入：“请读取 /workspace/docs/project_plan.md，并总结第三部分的关键里程碑。”
方法二：先列出可用文件，再选择读取
输入：“用 Glob 工具搜索 /workspace/docs 下所有 .md 文件 → 从结果中选中 requirements_v2.md → 用 Read 工具读取全文 → 提取其中的验收条件列表。”
方法三：跨文件关联分析
输入：“读取 /workspace/docs/architecture.png（图片需已转为OCR文本存为 .txt）和 /workspace/docs/db_schema.sql，对比字段命名是否一致。”
处理非文本资料（PDF/图片/Excel）
OpenClaw底层Harness默认只支持纯文本读取。PDF、PNG、XLSX等格式需提前转换，否则Read工具会返回乱码或空内容。
第一步：在宿主机完成预处理
用 pdftotext 将PDF转为UTF-8文本；用OCR工具（如Tesseract）提取图片文字；用 in2csv 导出Excel为CSV——全部保存为 .txt 或 .md 后缀，再放入挂载目录。
第二步：确保文件编码为UTF-8无BOM
某些Windows生成的TXT含BOM头，会导致Read工具解析失败。可用 file -i filename.txt 检查编码，用 iconv -f UTF-16 -t UTF-8 filename.txt > clean.txt 清理。
这一步操作起来很简单，直接把转换好的文本文件拖进挂载目录就行。
