OpenClaw（五）| 记忆系统增强

OpenClaw五| 记忆系统增强一、什么是记忆系统为什么需要升级记忆系统二、记忆系统版本选择2.1 版本对比2.2 升级路线与选择逻辑2.3 资源要求三、准备工作四、记忆系统健康检查1. 打开 CMD 命令提示符2. 执行健康检查命令3. 记忆插件配置选项4. 查看检查结果五、记忆系统配置5.1 启用本地 Embedding免费1. 安装 Ollama2. 下载 embedding 模型3. 配置 OpenClaw 使用本地 embedding4. Embedding 提供商选项5. 验证配置6. 重启 Gateway 服务5.2 进阶配置QMD 模式1. 检查系统兼容性2. 安装依赖3. 配置 QMD 模式4. 记忆后端选项5. QMD 搜索模式选项6. 预热模型7. 重启 Gateway 服务5.3 使用云服务 Embedding1. 设置环境变量2. 配置 OpenAI Embedding3. 重建索引4. 重启 Gateway 服务六、记忆参数优化适用于所有版本6.1 开启高级功能6.2 优化分块参数6.3 重启 Gateway 服务七、验证配置1. 检查记忆状态2. 测试搜索功能八、常见问题排查1. Gateway 服务未启动2. 模型下载失败3. 配置不生效九、总结一、什么是记忆系统OpenClaw 的记忆系统就像 AI 的大脑帮助它记住和检索信息。默认情况下记忆系统是基础版只能记住当前对话和你写的 MEMORY.md 文件但无法通过语义搜索长期记忆。通过本指南你可以将其升级为完全体获得更强的记忆能力。为什么需要升级记忆系统OpenClaw 默认采用基础版记忆系统主要基于以下考虑性能考虑向量模型embedding需要额外的计算资源本地模型可能对低端设备造成性能负担默认使用纯关键词搜索FTS-only保证基本功能的同时降低资源消耗依赖管理向量模型需要额外的依赖如Ollama默认配置避免强制用户安装额外软件保持最小化安装原则让用户按需扩展兼容性考虑不同用户的硬件和网络环境差异大默认配置确保在各种环境下都能正常运行高级功能如QMD模式有特定的系统要求用户体验简化初次安装和使用流程让用户先体验基本功能再根据需要升级避免因复杂配置导致的初期使用障碍升级后OpenClaw 将获得语义搜索能力可以更智能地理解和检索长期记忆提供更准确的回应。二、记忆系统版本选择OpenClaw 提供多种记忆系统配置方案这些方案之间是可选关系你可以根据自己的需求和资源选择适合的方案2.1 版本对比版本特点依赖费用适用场景支持环境配置章节基础版默认仅使用纯关键词搜索无需额外依赖免费入门用户和资源有限的设备所有平台Windows、macOS、Linux无需特殊配置本地增强版使用 Ollama 提供的本地 embedding 模型获得语义搜索能力需要安装 Ollama 和下载模型免费希望获得语义搜索能力但不想付费的用户所有平台Windows、macOS、Linux5.1 启用本地 Embedding高级版QMD 模式使用 QMD 后端提供更强大的搜索能力需要安装 Bun 和 QMD免费技术用户和对记忆能力有极致追求的用户仅支持 macOS 或安装了 WSL2 的 Windows5.2 进阶配置QMD 模式云服务版使用 OpenAI 等云服务的高质量 embedding 模型需要 API Key付费对记忆质量有较高要求的用户所有平台Windows、macOS、Linux5.5 使用云服务 Embedding重要说明对于 Windows 用户高级版QMD 模式需要将 OpenClaw 安装在 WSL2 环境中而不是 Windows 原生环境即使 Windows 系统已安装 WSL2若 OpenClaw 安装在 Windows 原生环境中仍无法使用 QMD 模式macOS 用户可以直接在原生环境中使用所有版本包括 QMD 模式2.2 升级路线与选择逻辑建议从基础版开始根据需要逐步升级路线一免费方案基础版 → 2. 本地增强版 → 3. 高级版QMD 模式路线二付费方案基础版 → 2. 云服务版 → 3. 高级版QMD 模式注意点本地增强版和云服务版是互斥的只能选择其中一种作为 embedding 提供商2.3 资源要求版本资源要求基础版低无需额外资源本地增强版中需要足够的磁盘空间和内存来运行 Ollama 和模型高级版QMD 模式高对系统资源要求更高建议在性能较好的设备上使用云服务版低主要依赖云服务但需要网络连接三、准备工作Node.js 版本确保 Node.js ≥ 22OpenClaw 安装确保已正确安装 OpenClawGateway 服务确保 Gateway 服务已启动后续会教你如何启动四、记忆系统健康检查1. 打开 CMD 命令提示符按下Win R输入cmd回车打开命令提示符2. 执行健康检查命令:: 检查 OpenClaw 状态 openclaw status :: 检查记忆系统状态 openclaw memory status --deep3. 记忆插件配置选项选项含义memory-core核心记忆插件提供基本记忆功能memory-lancedb使用 LanceDB 作为记忆存储提供更高效的向量搜索none禁用记忆插件4. 查看检查结果关注是否有错误信息记录当前的记忆配置状态五、记忆系统配置5.1 启用本地 Embedding免费1. 安装 Ollama访问 Ollama 官网 下载并安装安装完成后启动 Ollama 服务2. 下载 embedding 模型:: 拉取 nomic-embed-text 模型 ollama pull nomic-embed-text3. 配置 OpenClaw 使用本地 embedding:: 设置 embedding provider 为 ollama openclaw config set agents.defaults.memorySearch.provider ollama :: 设置 fallback 为 none防止回退到远程服务 openclaw config set agents.defaults.memorySearch.fallback none4. Embedding 提供商选项选项含义auto自动选择提供商无 API Key 时退化为纯关键词搜索openai使用 OpenAI 的 embedding 模型付费gemini使用 Google Gemini 的 embedding 模型voyage使用 Voyage AI 的 embedding 模型mistral使用 Mistral AI 的 embedding 模型ollama使用本地 Ollama 提供的 embedding 模型免费local使用本地其他 embedding 模型5. 验证配置:: 检查配置是否生效 openclaw memory status --deep确认显示provider: ollama6. 重启 Gateway 服务:: 重启 Gateway 服务 openclaw gateway restart5.2 进阶配置QMD 模式1. 检查系统兼容性支持平台macOS 或安装了 WSL2 的 WindowsWindows 用户需要先安装 WSL2不在本指南范围内2. 安装依赖:: 安装 Bun如果未安装 :: macOS: brew install oven-sh/bun/bun :: WSL2: curl -fsSL https://bun.sh/install | bash :: 安装 QMD CLI bun install -g https://github.com/tobi/qmd3. 配置 QMD 模式:: 设置记忆后端为 QMD openclaw config set memory.backend qmd :: 设置 QMD 搜索模式 openclaw config set memory.qmd.searchMode query4. 记忆后端选项选项含义builtin使用内置的 SQLite 后端qmd使用 QMD 后端提供更强大的搜索能力5. QMD 搜索模式选项选项含义query使用查询模式包含 embedding、reranker 和查询扩展search使用搜索模式性能更好但功能较少6. 预热模型:: 设置环境变量 set XDG_CONFIG_HOME%USERPROFILE%\.openclaw\agents\main\qmd\xdg-config set XDG_CACHE_HOME%USERPROFILE%\.openclaw\agents\main\qmd\xdg-cache :: 创建目录 mkdir %XDG_CONFIG_HOME% 2nul mkdir %XDG_CACHE_HOME% 2nul :: 预热模型 qmd update qmd embed qmd query test --json7. 重启 Gateway 服务openclaw gateway restart5.3 使用云服务 Embedding1. 设置环境变量按下Win R输入sysdm.cpl回车点击 “高级” → “环境变量”在 “用户变量” 中添加OPENAI_API_KEY值为你的 OpenAI API Key2. 配置 OpenAI Embedding:: 设置 provider 为 openai openclaw config set agents.defaults.memorySearch.provider openai :: 设置使用高质量模型 openclaw config set agents.defaults.memorySearch.remote.model text-embedding-3-large :: 开启批量索引 openclaw config set agents.defaults.memorySearch.remote.batch.enabled true3. 重建索引:: 强制重建索引 openclaw memory index --force4. 重启 Gateway 服务openclaw gateway restart六、记忆参数优化适用于所有版本记忆参数优化适用于所有记忆系统版本可以进一步提升记忆检索的效果和性能。6.1 开启高级功能:: 开启 MMR多样性搜索 openclaw config set agents.defaults.memorySearch.query.hybrid.mmr.enabled true :: 开启时间衰减让新记忆权重更高 openclaw config set agents.defaults.memorySearch.query.hybrid.temporalDecay.enabled true :: 开启会话记忆 openclaw config set agents.defaults.memorySearch.experimental.sessionMemory true :: 添加会话到记忆来源 openclaw config set agents.defaults.memorySearch.sources [\memory\, \sessions\]6.2 优化分块参数:: 设置更精细的分块 openclaw config set agents.defaults.memorySearch.chunking.tokens 300 openclaw config set agents.defaults.memorySearch.chunking.overlap 606.3 重启 Gateway 服务openclaw gateway restart七、验证配置1. 检查记忆状态openclaw memory status --deep2. 测试搜索功能向 OpenClaw 发送一条消息包含之前提到过的内容询问它是否记得相关信息验证记忆搜索是否正常工作八、常见问题排查1. Gateway 服务未启动:: 启动 Gateway 服务 openclaw gateway start2. 模型下载失败检查网络连接确保 Ollama 服务正在运行重试ollama pull nomic-embed-text命令3. 配置不生效确保已重启 Gateway 服务检查配置命令是否正确执行查看%USERPROFILE%\.openclaw\openclaw.json文件确认配置是否正确九、总结通过本指南的操作你已经成功将 OpenClaw 的记忆系统从基础版升级为完全体获得了以下能力语义搜索长期记忆更智能的记忆检索可自定义的记忆参数可选的高级 QMD 模式现在你的 OpenClaw 已经拥有了更强大的记忆能力可以更好地理解和回应用户的需求。