内存

Moltbot 如何记忆：代理工作区中的纯 Markdown 文件。文件是唯一真实来源；模型只「记住」被写入磁盘的内容。内存搜索工具由当前内存插件提供（默认：memory-core）。使用 plugins.slots.memory = "none" 可禁用内存插件。

内存文件（Markdown）

默认工作区布局使用两层内存：

• memory/YYYY-MM-DD.md — 每日日志（仅追加）。在会话开始时读取当天与昨天。
• MEMORY.md（可选）— 整理的长期记忆。仅在主、私密会话中加载（绝不在群组上下文中）。

这些文件位于工作区下（agents.defaults.workspace，默认 ~/clawd）。完整布局见 代理工作区。

何时写入内存

• 决策、偏好与持久事实写入 MEMORY.md。
• 日常笔记与运行上下文写入 memory/YYYY-MM-DD.md。
• 若有人说「记住这个」，就写下来（不要只留在内存）。
• 若希望某件事持久，让机器人把它写进内存。

自动内存刷新（压缩前提醒）

当会话接近自动压缩时，Moltbot 会触发一次静默、代理式轮次，提醒模型在上下文被压缩之前将持久记忆写出。默认提示中说明模型_可以回复_，但通常 NO_REPLY 才是正确响应，用户不会看到这一轮。由 agents.defaults.compaction.memoryFlush 控制：enabled、softThresholdTokens、systemPrompt、prompt。细节：软阈值在会话 token 估计超过 contextWindow - reserveTokensFloor - softThresholdTokens 时触发刷新；默认静默（提示含 NO_REPLY）；每个压缩周期仅刷新一次（在 sessions.json 中记录）；工作区必须可写（若会话在 workspaceAccess: "ro" 或 "none" 的沙箱中运行则跳过刷新）。完整压缩生命周期见英文文档。

向量内存搜索

Moltbot 可在 MEMORY.md 与 memory/*.md 上构建小型向量索引，使语义查询在措辞不同时也能找到相关笔记。默认启用。CLI：moltbot memory status、moltbot memory index、moltbot memory search "<query>"。更多选项与配置见英文文档。