Memory

OpenClaw 机器人的记忆，其实就是它工作文件夹里的一些 Markdown 文件。这些文件就是它记得的所有东西，它不会把东西只放在脑子里（也就是电脑的内存里），而是会乖乖地写下来。

记忆文件（Markdown 小本本） 默认情况下，机器人有两个主要的小本本：

1. memory/YYYY-MM-DD.md：这是它的每日日志，就像日记本。它每天都会往这个本子里加东西，而且只读今天和昨天的日记。
2. MEMORY.md：这是它的长期记忆本，记一些重要的决定、喜好和事实。这个本子只在它自己的私人对话里用，不会在群聊里看。

这些文件都放在一个叫“工作区”的文件夹里（默认是 ~/.openclaw/workspace）。

记忆工具（怎么找东西） 机器人有两个工具来读这些本子：

• memory_search：这个工具可以帮机器人“理解”你想找什么，然后从本子里找到意思相关的句子，即使你说的词和本子里写的不完全一样。
• memory_get：这个工具可以帮机器人精确地读到某个本子的某一页（某几行）。如果本子还不存在（比如今天还没开始写日记），它也不会出错，会告诉机器人“现在还没记东西呢”。

什么时候该写下来？

• 重要的决定、喜好和事实，要写到 MEMORY.md 里。
• 日常的笔记和聊天中提到的事情，就写到当天的日记本 memory/YYYY-MM-DD.md 里。
• 如果有人对机器人说“记住这个”，一定要写下来，不要只放在脑子里。
• 如果你想让机器人记住某件事，最好直接告诉它：“请把这个写到记忆里。”

自动提醒写记忆（清理前的“小闹钟”） 机器人聊天的“脑子”（上下文）快装满的时候，它会自动清理一些旧内容。在清理之前，它会悄悄地提醒自己：“快把重要的事情写到记忆本子里，不然就要忘啦！”这个提醒通常不会让你看到，机器人自己处理完就会继续和你聊天。这个功能需要工作区文件夹可以写入才能用。

向量记忆搜索（更聪明的找东西方法） 为了让 memory_search 更聪明，OpenClaw 可以给记忆本子里的内容建一个“向量索引”。这就像给每段话做了一个“意思指纹”，这样即使你说的词不一样，也能找到意思相近的笔记。

• 这个功能默认是开启的。
• 它会自动观察记忆文件有没有变化。
• 默认会尝试用远程服务（比如 OpenAI、Gemini 等）来生成“指纹”。你需要有对应服务的 API 密钥。
• 你也可以选择用本地模式，这需要安装 node-llama-cpp，可能会复杂一点。

QMD 后端（一个实验性的、更厉害的搜索帮手） 除了内置的方法，你还可以用一个叫 QMD 的外部工具来帮忙搜索。它结合了多种找东西的方法，可能更厉害，但设置起来也麻烦一些。

• 你需要先单独安装 QMD 的命令行工具。
• 它完全在本地运行，第一次用的时候可能会下载一些模型，所以会有点慢。
• 如果 QMD 没装好或者出错了，OpenClaw 会自动用回自己内置的搜索方法，所以记忆工具不会完全坏掉。

重要的提醒和限制

• 机器人只会给 Markdown 文件（.md 结尾）建索引。
• 如果你把工作区设置成只读（workspaceAccess: "ro"）或者不能访问（"none"），那么自动提醒写记忆的功能就不会工作。
• 用远程服务生成“指纹”需要 API 密钥。Codex OAuth 的密钥不能用于这个功能。
• 第一次使用 QMD 或者本地模式时，可能会因为下载模型而比较慢。