openclaw需手动启用rag插件并挂载向量数据库路径才支持文档上传；必须设置rag_enabled=true和rag_vector_store_path=/opt/rag-data，且宿主机目录存在并有写权限，否则界面无上传入口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让OpenClaw读取本地PDF、Word或Markdown文档来辅助编程或分析，但上传入口藏得深，界面没提示，直接拖文件会失败。
确认OpenClaw是否支持文档上传
OpenClaw本身不内置文档解析能力，它依赖后端LLM服务（如Ollama、vLLM或云API）提供RAG支持。若你用的是官方Docker镜像（docker.all-hands.dev/all-hands-ai/openhands:0.28），默认不开启文档上传功能；必须手动启用RAG插件并挂载向量数据库目录。
运行前检查环境变量：RAG_ENABLED=true 和 RAG_VECTOR_STORE_PATH=/opt/rag-data 是否已设置。缺一不可，否则界面上根本不会出现“上传”按钮。
启用RAG并挂载文档存储路径
第一步：停止当前运行的OpenClaw容器（如有）：docker stop openhands-app
第二步：新建RAG数据目录：mkdir -p $HOME/openclaw-rag-data
第三步：用带RAG参数的命令重新启动容器——关键在挂载路径和环境变量：
docker run -it --rm --pull=always \-e RAG_ENABLED=true \-e RAG_VECTOR_STORE_PATH=/opt/rag-data \-v $HOME/openclaw-rag-data:/opt/rag-data \-v /var/run/docker.sock:/var/run/docker.sock \-p 3000:3000 \--add-host host.docker.internal:host-gateway \--name openhands-app \docker.all-hands.dev/all-hands-ai/openhands:0.28
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
⚠️ 注意：必须把 /opt/rag-data 同时出现在 -e 和 -v 中，且宿主机路径要真实存在且有写权限，否则RAG服务启动失败，UI仍无上传入口。
在Web界面上传文档
方法一：通过侧边栏快捷入口
打开 http://localhost:3000 → 登录后点击左上角「+ New Chat」→ 新对话窗口右上角会出现一个? 图标 → 点击它 → 弹出文件选择框 → 选中PDF/DOCX/MD文件 → 点击「Upload」。
方法二：拖拽到聊天输入区下方空白处
进入任意对话 → 将文档直接拖入输入框正下方的浅灰色区域（不是输入框内，也不是顶部导航栏）→ 松手后自动触发解析进度条 → 解析完成显示「✅ Indexed: filename.pdf」。
上传后文档不会立即可见，需等待右下角小字提示「Embedding complete」，此时AI才能引用其中内容。若上传后10秒内无此提示，说明RAG服务未生效或文件格式不被支持（不支持加密PDF、扫描图转文字的PDF、.xls等非文本型文件）。
