openclaw memory¶
管理语义记忆索引、搜索、提升到 MEMORY.md 以及基于来源的删除。
由捆绑的 memory-core 插件提供。plugins.slots.memory 默认选择
memory-core。其他记忆插件会暴露各自的 CLI 命名空间。
当另一个插件拥有记忆插槽,而 memory-core 仅作为
dreaming 整合 sidecar 运行时:
memory status会报告所选 provider 的 id 和健康状态(以 host status authority 打开),并报告 dreaming 状态,而不是 Memory Core 自身的 索引。--json返回[{"agentId","provider","health","memoryCore":"consolidation-sidecar"}]。--deep、--index和--fix会以退出码 1 退出,因为它们检查 Memory Core 自身的索引。memory search会以退出码 1 退出,并指明插槽所有者,而不是 搜索 sidecar 索引。index、reset、forget、promote以及 REM 命令仍会在 Memory Core 的 sidecar 索引上继续工作,并打印相应通知(使用--json时输出到 stderr)。
相关:Memory 概念、Dreaming、 Memory 配置参考、Memory Wiki、 wiki、Plugins。
JSON 可用性¶
使用 --json 时,search、promote、promote-explain、rem-harness、
rem-backfill 和 session-backfill 会在任何工作运行之前报告记忆后端不可用:
- 禁用的记忆会返回
{"agentId":"main","status":"disabled"},并以成功退出。 - 后端获取失败会返回标准
{"ok":false,"error":{"type":"cli_error","message":"..."}}信封,外加agentId,并以退出码 1 退出。
无效的命令输入以及命令执行期间的错误也会使用标准 CLI JSON 失败信封,并以退出码 1 退出。失败 消息会解释命令错误;人类可读的诊断信息仍保留在 stderr。
在读取命令的正常结果字段之前,先处理这些结果。已启用但没有匹配项的搜索仍会返回 {"results":[]}。status --json
会保留可用 agent 的聚合数组,包括全部禁用时的 [];获取失败仍会设置非零退出码。
memory status¶
未指定 --agent 时,会为 agents.entries 中的每个 agent 运行;如果未配置 agent 列表,
则回退到默认 agent。
| 标志 | 效果 |
|---|---|
--deep |
检查 vector-store、embedding-provider 和 semantic-search 的就绪状态(意味着额外的 provider 调用)。普通的 memory status 保持快速并跳过此项;完整的持久化索引显示为 indexed (unprobed),而未知的 vector/semantic 状态表示未检查。 |
--index |
如果存储已脏,则重新索引。隐含 --deep。 |
--fix |
修复过期的 recall 锁并规范化 promotion 元数据。 |
--json |
打印 JSON。 |
--verbose |
输出详细的分阶段日志。 |
使用本地 llama.cpp 嵌入时,--deep 和 --index 还会显示可用的
server、model、capability 和 endpoint 诊断信息。
即使 dreaming.enabled: true,如果 Dreaming 行仍保持 off,或者
计划扫描似乎从未运行,受管理的 dreaming cron 依赖于默认 agent 的 heartbeat 触发来启动协调。有关
Dreaming 的调度细节,请参阅该文档。
状态还会列出来自 memory.search.extraPaths 的任何额外搜索路径。
存储诊断显示共享 agent 数据库文件、WAL、可重用空闲页,
以及保留的 embedding-cache 载荷字节数和条目数,包括缓存禁用时。按来源的文本加嵌入总计仅描述已索引的 chunk。
这些数值存在重叠:不要将载荷或可重用字节数加到文件大小上。
数据库还保存会话和其他 agent 状态;WAL 可能包含尚未
checkpoint 到主文件中的较新页面。JSON 在
status.storage 下公开这些事实。字节检查仅在显式诊断时运行,而不是普通
记忆搜索。
对于在初始化时才发现其默认 model 的 provider,普通 status
会推迟 model 身份检查,直到该 model 已知。使用 --deep 初始化
provider,并针对现有索引验证 model 和 provider 设置。
会话资格会排除未索引且解析内容完全由系统生成的转录,这与索引器的准入规则一致。这些 转录不会使状态保持脏;后续的用户内容会使它们重新具备 索引资格。
memory index¶
与 status 相同的按代理作用域。--force 会执行完整重新索引,而不是增量索引。--verbose 会在显示索引进度之前,打印每个代理的提供商、模型、来源和额外路径详情。完成消息会报告已索引的文件数量。空语料库是成功的空操作:命令会报告解析后的工作区路径以及没有索引任何内容,并将缺失的 memory/ 目录留给首次记忆写入时创建。内部梦境叙事、cron 和 heartbeat 会话记录会被排除在索引之外,包括原始会话不再活动的保留压缩叙事归档。之前由 memory forget 选定的会话也保持排除。--force 会删除这两组过期的索引记录,而不对它们保留的会话记录重新索引。普通的保留、重置和已删除用户会话归档在显式指定之前仍保持可索引。
完整重建会等待临时数据库清理完成后再报告完成。文件删除异步运行,因此清理不会阻塞 Gateway 事件循环。
当嵌入提供商对索引进行速率限制时,每个嵌入操作最多获得五次尝试。重试会遵循有效的提供商冷却提示,每次等待上限为 60 秒。其他瞬时错误保留较短的三次尝试预算。没有冷却提示的永久配额错误会停止该操作。详细输出会显示每次重试等待。
对于 OpenAI 和 OpenAI 兼容的嵌入,请设置
OPENCLAW_DEBUG_MEMORY_EMBEDDINGS=1 以记录远程请求次数、HTTP 状态、在提供时记录响应大小,以及向量形状。这些诊断信息会省略请求头、URL、输入文本和向量内容。验证错误会标识提供商、模型、批处理大小和被拒绝的条件。被拒绝的批次仍会中止索引;完整重建仅发布完整索引。
交互式 memory_search 保留三次尝试,并在代理工具的 30 秒截止时间之内,最多累计 8 秒的重试休眠。被取消的调用方会中断其重试等待。
在 OpenClaw 索引格式升级后,首次搜索会在返回结果前重建索引。重建可能需要更长时间,并且搜索结果会披露配置的嵌入提供商可能产生的费用。由更新版本的 OpenClaw 写入的索引会保持暂停;请升级 OpenClaw 或显式重新索引。后续搜索会复用修复后的索引;仅检查状态不会重建它。并发搜索会等待正在进行的修复。缓慢的修复可能超过交互式工具的截止时间;在已接受的索引工作完成之前,工具会报告不可用。如果格式修复在发布前失败,搜索会报告记录的同步错误并保留先前索引。重试前,请使用 memory status --deep 检查该失败。
如果更改嵌入设置后,status 报告了索引标识警告,请检查受影响代理的提供商、模型、来源和额外路径,然后重建:
openclaw memory status --deep --agent <id>
openclaw memory index --force --agent <id>
openclaw memory status --agent <id>
openclaw memory status --index --agent <id> 也会重建不兼容的索引。这两个修复命令都会替换派生记忆索引,同时保留其他代理状态。使用 --agent 可将修复限制在受影响的代理。
Warning
默认的 openclaw-agent.sqlite 数据库还包含规范会话、会话记录和其他持久代理状态。切勿删除它或其 -wal、-shm 或 -journal 伴随文件来重置记忆索引。请使用 memory index --force 重建,或使用 memory reset 清除派生索引和嵌入缓存;参见 安全索引恢复。
memory reset¶
清除内置记忆索引和嵌入缓存,而不删除会话、会话记录或记忆文件。
与 status 和 index 相同的按代理作用域:未指定 --agent 时,reset 会为每个已配置的代理运行,当未配置列表时回退到默认代理。该命令会请求确认。--yes 会跳过提示,并且在非交互式终端中是必需的。
Reset 只会原子地删除并重新创建 agents/<agentId>/agent/openclaw-agent.sqlite 中由记忆拥有的派生表,清除已索引内容和缓存的嵌入,同时保留必需的修订记录。非记忆数据库表和记忆源文件保持不变。没有索引的代理是成功的空操作。Reset 会与现有记忆维护协调,并且不会重启 Gateway;正在运行的 Gateway 之后可以重新索引保留的来源。如果索引正在忙碌,请让它完成后再重试 reset。
之后从保留的来源重建:
Reset 不会缩小数据库文件,也不会恢复因删除它而已经丢失的数据。若要回收磁盘空间,请在重建前遵循 磁盘空间恢复。它不是隐私清除:使用 memory forget 删除从选定会话派生的受跟踪记忆,并防止重新摄取。
memory search¶
openclaw memory search [query] [--query <text>] [--agent <id>] [--max-results <n>] [--min-score <n>] [--json]
- 查询:位置参数
[query]或--query <text>。如果两者都设置,--query优先。如果两者都未设置,命令会报错。 --agent <id>:默认为默认代理(不是完整代理列表)。--max-results <n>:限制结果数量(正整数)。--min-score <n>:过滤掉低于该分数的匹配项。
常规索引可以在搜索返回后继续,并且不会添加警告。如果自动索引失败,或索引标识不兼容,人类可读输出会警告匹配可能不完整。使用 --json 时,响应会添加 stale: true,以及 warning 和 action 字段。仅当 stale 不存在时,才将空的 results 数组视为权威结果。
Control UI 的 Memories 选项卡会在过时的搜索结果旁边显示相同的警告和恢复指引,并在执行新的搜索后清除它们。
memory forget¶
删除从所选会话派生的可识别记忆产物,并在一个代理的存储中将这些会话记录为已遗忘。有关谱系、准入策略和删除覆盖范围之间的关系,请参阅记忆来源与删除。
Warning
除非设置了 --dry-run,否则该命令会立即删除。没有确认提示或 --apply 标志。源会话转录会被保留。
先进行预览:
openclaw memory forget --agent <agent-id> --session <id-or-key> --dry-run --json
openclaw memory forget --agent <agent-id> --hook-source gmail --dry-run --json
openclaw memory forget --agent <agent-id> --participant <actor-id> --dry-run --json
检查报告后,重复执行预期命令,但不带 --dry-run。
| 标志 | 效果 |
|---|---|
--agent <id> |
选择一个代理。默认为默认代理,而不是所有代理。 |
--session <id-or-key> |
按会话 ID 或密钥选择;可重复。 |
--hook-source <source> |
选择具有此已记录外部内容钩子来源的实时会话;可重复。 |
--participant <actor-id> |
选择具有此已记录参与者 actor ID 的实时会话;可重复。 |
--since <date> |
包含在该日期当天或之后创建的会话。使用带时区的 ISO 时间戳作为无歧义的截止点。 |
--dry-run |
计算报告,但不更改记忆文件、索引、插件状态或已遗忘会话记录。 |
--json |
以 JSON 格式打印完整报告。 |
会话选择¶
至少需要一个选择器。重复的值和不同的选择器类型以 OR 组合:匹配任一选择器的会话都会被选中,并受 --since 约束。选择器匹配已记录的标识符,而不是消息中的名称或文本。参与者选择器会选择整个会话,包括其他参与者的贡献。
--participant 有意跨身份命名空间匹配原始 actor ID;它不是仅针对 Profile 的选择器。报告中的 participantMatches 会显示与每个请求 ID 匹配的带类型身份,包括模糊匹配。删除前,请在 --dry-run --json 中审查这些身份以及所选的完整会话。Profile 合并不会静默地重新解释原始选择器。
显式 ID 和密钥会在配置的 session.store 中的实时会话和保留归档中解析,包括自定义存储和共享存储。匹配仍限定在所选代理范围内。
报告会将每个结果标记为 live、archived 或 unresolved。未解析的显式值会按字面记录为会话 ID,用于将来排除;它并不能证明已找到所请求的会话。ID 精确匹配且区分大小写,包括匹配保留归档名称时。缩写不会选择更长的会话 ID。
钩子来源和参与者选择器需要实时元数据;仅归档的记录不会保留这些事实。请通过完整 ID 或密钥选择这些归档。钩子来源匹配是精确的:IMAP 使用 email,Gmail 钩子使用 gmail,通用 webhook 使用 webhook。当原始精确来源丢失时,仅包含粗略 webhook 分类的旧保留记录无法区分 IMAP 和通用 webhook;请改用完整 ID 选择这些会话。--since 使用实时会话的创建时间或归档的创建时间,而不是单个消息的时间戳。未解析的显式 ID 没有时间戳,并且仍会被选中。
阅读报告¶
| 字段 | 含义 |
|---|---|
agentId, dryRun |
所选存储以及本次是否为预览。 |
sessionIds, sessionResolutions |
所选 ID 以及每个 ID 的解析方式;解析结果可能还包括 sessionKey。 |
entryKeys |
在所选会话中至少有一个来源的条目密钥。 |
mixedLineageEntryKeys |
同时具有未选中来源的已选条目;它们会被整体删除。 |
untargetableEntryKeys |
在此代理存储中发现的没有来源行的晋升标记。这不会枚举未标记的文本。 |
curatedWrites |
需要审查的文件,包含 relativePath 和 observedAt(Unix 毫秒)。包括受支持的已记录写入尝试,这些尝试可能未成功。 |
artifacts |
下文描述的匹配文件、条目、行和存储行的计数。 |
refusals |
需要人工审查的历史整合高亮项。空列表并不能证明已实现完整的删除覆盖。 |
| 字段 | 含义 |
|---|---|
Preview 和 apply 使用相同的匹配逻辑,但每次都会读取当前状态; Preview 不是不可变的计划,也不是对后续写入的锁。Apply 与 memory 插件的暂存和文件变更进行协调。它在准备后重新检查 所选谱系,如果发生变化则刷新计划,同时保留已识别为属于所选会话的条目。索引 会丢弃过期结果,而不是恢复已清除的块或缓存嵌入; 重新运行报告源变更的索引命令。直接代理编辑和 外部写入者不共享该锁,因此在敏感 清理期间暂停它们。之后重新运行 Preview。空选择或零计数并不能 证明没有相关数据残留。
如果删除失败¶
删除不是跨文件和存储的单个事务。索引和插件状态
清理(包括重写备份)在 memory 文件编辑之前运行;语料库和
来源证据最后删除,以便重试时能够识别剩余产物。
如果清除失败,请解决报告的存储或文件系统错误,并使用相同选择器重新运行
相同命令。不要手动删除其语料库或来源
记录。成功后,使用 --dry-run 重复该命令以
查看剩余内容。
已删除的产物¶
清除会从扫描的 memory 文件中删除匹配的 promotion-marker 条目和 session-reference 部分,删除所选 session-corpus 行,以及 所选会话的 transcript 索引块。它会清除关联的全文和 向量行、匹配的短期状态、摄取 seen-hash 范围,以及来源 行。匹配内容会从 dreaming 重写备份中清除,而不是 删除每个备份。
对于非空会话选择,Forget 还会清除所选代理的整个 嵌入缓存,包括从未完成索引重建中保留的结果。这些 结果可能尚未链接到已发布索引块。无关的已发布 索引条目仍可使用,但后续索引可能需要重新生成其 缓存嵌入。试运行报告包含整个缓存的删除计数; 试运行或空会话选择不会清除缓存。
整合会为被替换的 promotion marker 保留来源,同时保留的 重写前像引用它们。这些来源只有在活动 条目、保留的前像、日记摘录和索引快照停止引用这些键之后才会被修剪。 新的整合历史摘录携带替换条目的谱系, 并随其一起删除。只要摘录仍然存在,其来源就会保留,即使 在备份轮换之后;日记历史没有自动过期。 在共享工作区中,针对另一个代理的后续清除也会检查其索引 快照,即使第一次清除已经删除了共享文件内容。
当选择非空时,它还会清除内部 dreaming-narrative、cron 或 heartbeat 会话的过期索引记录。因此,索引清理可能 包含所选会话之外的内容,并且来自已更改 memory 文件的所有块都可能被失效,以便后续重新索引。
artifacts 计数器为:
memoryFiles、memoryEntries、memoryLines:已更改的 memory 文件、 已删除的标记条目或 session-reference 部分,以及包含精确所选语料库片段的额外整行。sessionCorpusFiles、sessionCorpusLines:已更改的语料库文件和 已删除的语料库行。indexChunks、indexSources、ftsRows、vectorRows、embeddingCacheRows:已删除的索引和缓存记录。shortTermEntries、seenHashScopes、backups、originRows:已删除的 短期条目和去重范围、已重写的备份记录,以及 已删除的来源行。
具有混合谱系的条目会被整体删除;该命令不会重写 它们以仅保留未选中的贡献。幸存的来源以后可能支持 新条目,但不保证重新生成。
重新准入与保留数据¶
实际清除会在删除产物之前,在代理的
SQLite 数据库中将所选会话 ID 记录为 forgotten。自动 dreaming 摄取、
memory session-backfill 以及 transcript 索引(包括
memory index --force)会检查这些记录。自动摄取会记录原因
forgotten。重复清除不会移除排除,并且
删除准入策略规则也不会撤销它。具有新
ID 的未来会话不会被之前的清除排除。
新的 session-backfill 日记事实和反思携带条目标记和
来源,包括由失败的 apply 留下的 REM 预览和日记块。
遗忘会删除每个匹配行,包括转换或合并的声明;
无关行保留。历史未标记的回填文本没有可重建的谱系。
在 DREAMS.md 和
memory/dreaming/**/*.md 等梦境日记中的精确语料库引用可以作为整行删除。未跟踪的改写
无法可靠归属,因此保留。
仅凭 curatedWrites 记录不会删除文件或其自由格式编辑。
保留的 transcript 中最新的文件级 write-observer 记录以及受支持的 write、edit
和 apply_patch 调用会标识需要审查的文件。
这不是对 shell 写入或外部编辑器的完整审计。报告的文件
仍可能通过单独的 marker、session-reference 或
精确引用清理被更改。
Warning
在 source-session 跟踪之前暂存的条目可能缺少来源行,并在清除后保留;
请单独审查它们。当前会话回填保留
来源,但不会重建缺失的历史谱系。
来源行已经丢失的重写备份也需要单独
审查;这不会自动修复之前不完整的清除。
untargetableEntryKeys 不会枚举每个未跟踪的候选项或 memory。
源转录、保留的归档、其他代理的索引、导出以及外部备份也需要单独审查。特别是,会话删除 通常会保留已删除转录归档;它并不是清除所有会话副本。
memory promote¶
对来自 memory/YYYY-MM-DD.md 的短期候选项进行排序,并可选择将排名靠前的条目追加到 MEMORY.md。
openclaw memory promote [--agent <id>] [--limit <n>] [--min-score <n>] \
[--min-recall-count <n>] [--min-unique-queries <n>] [--apply] [--include-promoted] [--json]
| 标志 | 默认值 | 效果 |
|---|---|---|
--limit <n> |
所有候选项 | 最大返回/应用的候选项数量。 |
--min-score <n> |
0.75 |
最低加权提升分数。 |
--min-recall-count <n> |
3 |
所需的最低召回次数。 |
--min-unique-queries <n> |
3 |
所需的最低不同查询数量。 |
--apply |
仅预览 | 将选中的候选项追加到 MEMORY.md,并将其标记为已提升。 |
--include-promoted |
关闭 | 包含在之前周期中已提升的候选项。 |
--json |
关闭 | 打印 JSON。 |
CLI 和计划中的 dreaming 扫描共享以下深度阶段默认值。显式 CLI 标志会在一次性手动运行时覆盖它们。
具有 untrusted 或 system 来源的条目会在排序前被排除,因此它们不会占用预览限制,也不会出现在 promote-explain 中。提升在写入前仍会重新检查当前来源。
排序信号:召回频率、检索相关性、查询多样性、时间新近性、跨天整合以及派生概念丰富度,来自记忆召回和每日摄取过程,并加上针对重复 dreaming 回访的 light/REM 阶段强化加成。写入前,提升会重新读取实时每日笔记,因此排序之后对短期片段的编辑或删除会被尊重,而不是从过期快照中提升。
memory promote-explain¶
解释单个提升候选项的分数明细。
<selector> 匹配候选项的键(精确或子字符串)、路径或片段文本。
memory rem-harness¶
预览 REM 反思、候选事实以及深度阶段提升输出,而不写入任何内容。
openclaw memory rem-harness [--agent <id>] [--path <file-or-dir>] [--grounded] [--include-promoted] [--json]
--path <file-or-dir>:从历史YYYY-MM-DD.md每日文件而非实时工作区为 harness 提供种子。--grounded:还会从历史笔记中渲染一个基于事实的What Happened/Reflections/Possible Lasting Updates预览。
memory rem-backfill¶
将基于事实的历史 REM 摘要写入 DREAMS.md 以供 UI 审查。可逆。
openclaw memory rem-backfill --path <file-or-dir> [--agent <id>] [--stage-short-term] [--json]
openclaw memory rem-backfill --rollback [--rollback-short-term] [--json]
--path <file-or-dir>:除非设置了--rollback/--rollback-short-term,否则必填。要从中回填的历史每日记忆文件或目录。--stage-short-term:还会将基于事实的持久候选项注入实时短期提升存储,以便正常深度阶段对它们进行排序。--rollback:从DREAMS.md中移除之前写入的基于事实的日记条目。--rollback-short-term:移除之前暂存的基于事实的短期候选项。
memory session-backfill¶
将保留的会话历史提炼为基于事实的短期候选项。它与 dreaming 共享转录信任分类、准入策略和语料库存储。暂存的候选项会保留每个贡献会话的来源,以便 memory forget 之后可以选择它们。配置的排除项适用于预览、REM 和应用模式;已遗忘的会话在所有模式下均保持排除。默认是只读预览,按从最旧的未处理日期到最新的顺序排列。
openclaw memory session-backfill --agent <id> [--from YYYY-MM-DD] [--to YYYY-MM-DD] \
[--limit-days <n>] [--archive-files <path...>] [--rem | --apply] [--json]
openclaw memory session-backfill --agent <id> --rollback [--json]
| 标志 | 默认值 | 效果 |
|---|---|---|
--from YYYY-MM-DD |
无 | 包含 dreaming 时区中当天及之后的消息。 |
--to YYYY-MM-DD |
无 | 包含 dreaming 时区中当天及之前的消息。 |
--limit-days <n> |
92 |
最多处理这么多未哈希跟踪的天数,从最旧开始。 |
--archive-files <path...> |
无 | 还将外部转录文件作为不受信任的输入进行检查;不接受嵌入的所有者元数据。 |
--rem |
关闭 | 将确定性的基于事实的每日预览写入 DREAMS.md,并保留其来源记录。 |
--apply |
仅预览 | 处理完所有有界批次,暂存受信任的候选项,并写入可逆的 DREAMS.md 日记块。 |
--rollback |
关闭 | 移除所有基于事实的回填候选项和共享回填日记块,包括 rem-backfill 产物。 |
| 标志 | 默认 | 效果 |
|---|---|---|
--json |
off | 打印机器可读的每日计数和前几位候选。 |
该命令读取所选 agent 的规范会话存储,包括
会话轮换中保留的 SQLite 转录标识。它使用与实时会话摄取相同的
已跟踪消息哈希和每次运行上限,因此重复的
--apply 运行会跳过已摄取的消息。来自规范存储的
owner 和 agent 行符合条件;工具输出、web 或非 owner 输入,以及没有
可信 owner 来源信息的轮次会被排除。外部归档文件没有
经过认证的 owner 来源契约,因此其内嵌的所有权字段
仍不可信,且不能被暂存。之前使用
memory forget 清除的会话会持续保持排除状态,即使
其原始转录仍然存在或其已跟踪哈希已被
清除。
--apply 在一次调用中将所选历史完整排空,同时
让每个有界批次保持在自己的事务中。人类可读和 JSON 输出会报告
每个批次的进度,以及总批次数、候选数和已暂存条目数。因此,
成功 apply 后立即执行 preview 会报告零个新
候选。它只写入 memory/.dreams/ 下的会话语料库、短期
暂存状态,以及 DREAMS.md 中可逆的日记条目。它从不写入
MEMORY.md 或 USER.md;持久提升仍然是单独的 memory promote
或 dreaming 决策。--rem 和 --apply 互斥。
两种写入模式都会在发布文本前记录日记来源,因此后续的 apply 失败不会留下无法追溯的日记引用。REM 只保留 日记及其来源簿记:它不保留会话语料库、不暂存 候选、不推进摄取游标,也不调用模型。
回填回滚有意与 memory rem-backfill 共享:两个
命令都使用相同的仅限 grounded 的暂存类和日记标记。只有当你打算清除该工作区中两个命令的
grounded 回填产物时,才运行
session-backfill --rollback。回滚还会移除
由会话回填添加的已跟踪哈希,并回退受影响的转录
游标,因此存活的符合条件候选可以再次预览并应用。
回滚不会移除已遗忘会话记录,也不会重新接纳已清除的会话。
Dreaming¶
Dreaming 是后台记忆整合系统,包含三个协作
阶段,按顺序在一个计划中运行:light(排序/暂存短期
材料)、REM(反思并浮现主题)、deep(将持久
事实提升到 MEMORY.md)。只有 deep 会写入 MEMORY.md。
- 通过
plugins.entries.memory-core.config.dreaming.enabled: true启用 (默认true);memory-core会自动管理 sweep cron 任务,无需手动openclaw cron add。 - 在聊天中通过
/dreaming on|off切换;使用/dreaming status检查 (或/dreaming//dreaming help)。on/off需要频道 owner 状态 或网关operator.admin;status和帮助对任何能够调用该命令的人保持可用。 - 人类可读的阶段输出会写入
DREAMS.md(或已存在的dreams.md)。 默认情况下(dreaming.storage.mode: "separate"),每个阶段还会将独立报告写入memory/dreaming/<phase>/YYYY-MM-DD.md;设置mode: "inline"可将报告折叠到每日记忆文件中,或设置"both"同时使用两者。 - 计划任务和手动
memory promote运行共享相同的 deep 阶段排名 信号和默认阈值;显式 CLI 标志仍为单次运行覆盖。 - 计划运行会分发到每个已配置 agent 的记忆工作区。
计划默认值(plugins.entries.memory-core.config.dreaming):
| 键 | 默认 |
|---|---|
frequency |
0 3 * * * |
phases.deep.minScore |
0.75 |
phases.deep.minRecallCount |
3 |
phases.deep.minUniqueQueries |
3 |
phases.deep.recencyHalfLifeDays |
14 |
phases.deep.maxAgeDays |
30 |
phases.deep.maxPromotedSnippetTokens |
160 |
完整键列表和阶段详情:Dreaming、 Memory 配置参考。
SecretRef 网关依赖¶
如果活动的 memory 远程 API 密钥字段被配置为 SecretRefs,memory
命令会从活动网关快照中解析它们;如果网关不可用,命令会快速失败。这需要支持
secrets.resolve 方法的网关;较旧的网关会返回未知方法错误。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw