什么是Memory Setup (OpenClaw)
OpenClaw 记忆回溯系统（Memory Setup）是一个专为智能代理设计的持久化上下文管理工具，旨在让 AI 代理能够长期记住用户决策、偏好和待办事项等重要信息。通过结构化地组织工作区内的记忆文件，并配置相应的检索机制，该系统使代理能够在多轮对话中保持连贯性和个性化服务。其核心在于将分散的记忆条目整合为可搜索的知识库，从而提升代理对历史上下文的理解深度与响应准确性。 该系统的实现依赖于两个关键组件：一是本地或远程的记忆索引提供者（provider），支持包括本地模型、OpenAI、Gemini、Voyage 和 Mistral 等多种后端；二是灵活的配置文件结构，允许开发者精确控制搜索范围、匹配阈值及结果数量。所有配置必须置于 `agents.defaults.memorySearch` 层级下，而非顶层设置，这是确保功能正常启用的必要条件。此外，系统要求在工作区根目录维护 `MEMORY.md` 作为主记忆文档，并按日期归档每日笔记至 `memory/YYYY-MM-DD.md` 文件夹中，形成层次化的记忆存储体系。 为了确保记忆功能的有效运行，建议遵循一套标准操作流程：在回答涉及过往工作、时间节点、人物偏好或任务清单的问题时，优先执行 `memory_search` 进行初步筛选，再根据需要使用 `memory_get` 提取具体段落内容，并在输出中标注引用来源路径与行号。这种做法不仅增强了回答的可信度，也便于后续审计与调试。
核心功能特点
- 支持多种记忆检索提供者（本地、OpenAI、Gemini、Voyage、Mistral）
- 基于 `MEMORY.md` 和按日归档的 `.md` 文件构建分层记忆库
- 可配置搜索参数如最大返回结果数（maxResults）与最低匹配分数（minScore）
- 强制要求配置位于 `agents.defaults.memorySearch` 层级以确保生效
- 提供 `memory_search` 和 `memory_get` 工具用于精准检索与引用
- 重启网关后需验证状态并通过 CLI 命令确认记忆模块正常运行
适用场景
OpenClaw 记忆回溯系统特别适用于需要长期维持用户交互一致性的智能代理应用场景。例如，在一个持续跟踪项目进度、记录客户偏好的客服机器人中，该系统能确保每次会话都能准确引用之前的沟通记录或定制方案，避免重复询问或信息冲突。对于个人助理类应用，它可以帮助代理记住用户的日程安排、饮食禁忌或阅读偏好，从而提供高度个性化的建议和服务。 另一个典型用例是团队协作型 AI 助手，其中多个成员可能共享同一工作区并依赖共同记忆来协调任务分配与决策过程。通过集中管理 `memory/projects/` 或 `memory/groups/` 下的相关文档，系统可确保每位成员获取到最新的协作动态与历史决议，提升团队效率。此外，在法律咨询、医疗辅助等专业领域，该系统还可用于保存案例摘要、诊断记录等敏感但重要的上下文信息，在保证隐私合规的前提下增强服务的连续性与专业性。 当遇到记忆召回质量不佳的情况时，用户可通过调整 `minScore` 降低过滤门槛以扩大检索范围，或增加 `maxResults` 获取更多候选结果。同时，定期更新 `MEMORY.md` 和日常日志内容有助于提高检索精度——越详细、结构化的输入文本，越容易生成高质量匹配项。若本地模型表现不稳定，也可切换至云端 API 提供商并配置对应密钥以保障服务可靠性。