OpenClaw不直接支持传统文档导入，需通过微代理机制动态触发知识检索：先确认LLM提供商已启用RAG扩展服务（UI中查看模型旁【RAG-enabled】标识），再在提示词中使用“参考文档”“查阅文件路径”或“按手册vX.X”等结构化关键词触发；挂载外部知识源仅限Docker部署，须严格匹配容器内路径并重启构建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw配置API Key后接入知识库，需明确其不直接支持传统文档型知识库导入，而是通过微代理（Microagent）机制在运行时动态触发知识检索能力——这要求你先确认所用LLM提供商是否已启用RAG扩展服务，再在任务提示词中显式调用关键词触发。
确认LLM提供商是否支持RAG微代理
打开OpenClaw Web UI右上角齿轮图标 → 进入“LLM Settings” → 查看当前选中的模型（如Claude 3.5 Sonnet或DeepSeek-R1）右侧是否有【RAG-enabled】绿色标识。若无该标识，说明该模型实例未启用知识检索插件，后续所有知识调用将静默失败。
部分云厂商（如华为MaaS）需额外开通“向量检索服务”并绑定模型实例，此操作不可逆且会产生独立计费项。
在提示词中触发KnowledgeMicroagent
新建会话后，在输入框中写明需求时，必须包含至少一个预定义的触发关键词：
- 方法一：使用“参考文档”作为前缀，例如：“参考文档：请根据公司内部API规范，生成Python调用示例”
- 方法二：嵌入文件路径提示，例如：“查阅/workspace/docs/auth_flow.md，解释OAuth2流程”
- 方法三：调用领域术语，例如：“按《支付网关集成手册》v2.3，补全缺失的header字段”
注意：OpenClaw不会自动扫描整个workspace目录。只有当提示词中出现上述三类结构化表述时，系统才会激活KnowledgeMicroagent，并将语义向量化后查询已注册的知识源。
为 OpenClaw 创建可直接分流的 GitHub issue 草稿，用于报告代理缓慢、损坏、无响应、工具匮乏、性能下降或“不够智能”等问题。使用 ...
挂载外部知识源（仅限Docker部署）
第一步：确保宿主机上已准备好知识库文件集，存放于/path/to/kb/目录下，格式仅支持Markdown、PDF、TXT三种，单文件不超过8MB。
第二步：停止当前OpenClaw容器 → 重新运行docker命令，追加挂载参数：-v /path/to/kb:/opt/knowledge_base:ro
第三步：进入UI设置页 → 在“Advanced Options”中手动填写【Knowledge Base Path: /opt/knowledge_base】 → 点击Save。此路径必须与docker -v参数中容器内路径完全一致，否则启动时会报错退出。
第四步：重启容器后，首次触发知识检索将自动完成向量化索引构建，耗时取决于文件总大小，期间UI无响应属正常现象。
