英文 Memory
- 原始链接：https://docs.openclaw.ai/concepts/memory
- 来源章节：4. 官方文档：核心概念、模型与安全
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/concepts/memory
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
内存概述 - OpenClaw
[OpenClaw主页！图片1：深色徽标！图片2：深色徽标](http://docs.openclaw.ai/)
英语
搜索...
⌘K
搜索...
导航
内存
内存概览
基础知识
会话和内存
多代理
消息和传递
在此页面上
内存
内存概览
内存概览
OpenClaw 通过在代理的工作区中编写纯 Markdown 文件来记住事情。该模型仅“记住”保存到磁盘的内容 - 没有隐藏状态。
它是如何运作的
你的代理有两个地方可以存储记忆：
MEMORY.md— 长期记忆。持久的事实、偏好和决定。在每个 DM 会话开始时加载。memory/YYYY-MM-DD.md— 每日笔记。运行上下文和观察结果。今天和昨天的笔记会自动加载。
这些文件位于代理工作区中（默认为“~/.openclaw/workspace”）。
如果你想让你的代理记住一些事情，只要问它：“记住我更喜欢 TypeScript。”它将把它写入适当的文件。
记忆工具
该代理有两个用于处理内存的工具：
memory_search— 使用语义搜索查找相关注释，即使措辞与原文不同。memory_get— 读取特定的内存文件或行范围。
这两个工具都是由活动内存插件提供的（默认值：“内存核心”）。
内存搜索
配置嵌入提供程序后，“memory_search”使用混合搜索 — 将向量相似性（语义含义）与关键字匹配（ID 和代码符号等精确术语）相结合。一旦您拥有任何受支持的提供商的 API 密钥，此功能即可开箱即用。
OpenClaw 会根据可用的 API 密钥自动检测您的嵌入提供程序。如果您配置了 OpenAI、Gemini、Voyage 或 Mistral 键，则会自动启用内存搜索。
有关搜索工作原理、调整选项和提供程序设置的详细信息，请参阅内存搜索。
内存后端
内置（默认）
基于 SQLite。开箱即用，具有关键字搜索、向量相似度和混合搜索功能。没有额外的依赖。
QMD
具有重新排序、查询扩展以及对工作区外部目录进行索引的能力的本地优先 sidecar。
本町
具有用户建模、语义搜索和多代理感知功能的 AI 原生跨会话内存。插件安装。
自动内存刷新
在 compaction 总结您的对话之前，OpenClaw 会运行一个静默转弯，提醒代理将重要的上下文保存到内存文件中。默认情况下此功能处于启用状态 - 您无需配置任何内容。
内存刷新可防止压缩期间上下文丢失。如果您的代理在对话中有重要事实尚未写入文件，它们将在摘要发生之前自动保存。
做梦（实验）
做梦是记忆的可选背景巩固过程。它会重新访问日常文件中的短期回忆（memory/YYYY-MM-DD.md），对其进行评分，并仅将合格的项目提升到长期记忆中（MEMORY.md）。它旨在保持长期记忆高信号：
- 选择加入：默认禁用。
- 计划：启用后，“内存核心”会自动管理重复任务。
- 阈值：促销必须通过分数、召回频率和查询多样性门。
有关模式行为（“off”、“core”、“rem”、“deep”）、评分信号和调谐旋钮，请参阅 Dreaming（实验）。
命令行界面
openclaw内存状态#检查索引状态和提供者
openclaw memory search "query" # 从命令行搜索
openclaw内存索引 --force # 重建索引
进一步阅读
- 内置内存引擎 — 默认 SQLite 后端
- QMD 内存引擎 — 高级本地优先 sidecar
- Honcho Memory — AI 原生跨会话内存
- 内存搜索 — 搜索管道、提供程序和调优
- Dreaming（实验） — 从短期回忆到长期记忆的背景提升
- 内存配置参考 — 所有配置旋钮
- Compaction — 压缩如何与内存交互
⌘我