溯源与删除
OpenClaw 为通过自动会话摄取和历史会话回填暂存的记忆记录来源会话谱系。openclaw memory forget 使用该谱系移除已跟踪的条目和相关工件,并将所选会话记录为已遗忘,以便后续摄取不会恢复它们。
两种控制服务于不同目的:准入策略 将匹配的会话排除在未来的梦境摄取和会话回填之外;遗忘 从所选会话中移除可识别的工件。两者都不是对智能体所见或所写内容的全盘擦除。
这些控制属于捆绑的 memory-core 插件。其他记忆插件可能提供不同的命令和删除行为。
Warning
memory forget 会立即删除,除非你传入 --dry-run。它不会删除原始会话记录、所有自由形式记忆编辑,或其所扫描的记忆存储之外的副本。在应用之前,请审阅报告和删除边界。
预览并遗忘会话¶
使用显式智能体,以便你知晓正在更改哪个存储。列出其会话以找到完整的会话键或 ID。会话 ID 是精确且区分大小写的;缩写不会选择更长的 ID:
openclaw sessions --agent <agent-id> --limit all --json
openclaw memory forget --agent <agent-id> --session <id-or-key> --dry-run --json
检查 sessionResolutions 以确认目标会话,entryKeys 和 mixedLineageEntryKeys 用于整条目移除,artifacts 用于受影响的存储。分别审阅 curatedWrites 和 untargetableEntryKeys;两者都不是剩余数据的完整清单。
当选择正确时,重复相同的命令但不带 --dry-run:
没有额外的确认提示或 --apply 标志。预览是根据当前状态计算的,不会保存为删除计划。在敏感清理期间,暂停直接智能体编辑和外部写入者;它们不共享记忆插件的变更锁。之后再次运行预览,检查是否还有可归属的工件残留。
如果删除失败,请解决报告的存储或文件系统错误,重新运行相同的命令,然后使用 --dry-run 重试。失败可能留下部分清理。清除过程会保留语料和来源证据,直到相关工件被清理;不要手动删除这些证据来消除错误。
完整标志、选择器语义和报告字段参见 memory forget。
记录了哪些谱系¶
三条记录服务于不同目的:
| 记录 | 粒度 | 写入者 | 用途 |
|---|---|---|---|
| 块来源 | 索引块 | 索引时的分类代码 | 信任门控与回忆框架 |
| 条目来源 | 已跟踪条目 | 会话摄取、回填和整合 | 查找源自所选会话的条目 |
| 策展写入记录 | 记忆文件 | 记忆写入观察器 | 在清理过程中识别需审阅的文件 |
策展写入查找仅读取请求的物理工作区。其他工作区记录中的损坏 JSON 不会阻塞该查找;所选工作区中活动记录的损坏 JSON 仍会报告存储错误。
块来源 描述了来源类别和会话类型。条目来源则相反,将条目键与智能体及 SQLite 中的源会话关联起来。MEMORY.md 中的提升标记将可见条目连接到这些来源行。
当梦境合并或取代已跟踪条目时,对账会将父条目的来源转移到幸存的条目上。它运行在模型调用周围的代码中,包括共享工作区的参与智能体;模型并不拥有来源行。
文件替换可能在后续文件错误报告之前就已成功。在这种情况下,或当发布不确定时,整合会保留替换条目的来源,以便后续的 memory forget 仍能定位到它。它不会自动将不确定的替换作为追加重试。
只要保留的改写前像仍引用其提升标记,被替换条目的来源就会保留。只有当活动条目、保留前像、日记摘录和索引快照不再引用它们时,备份轮换才会修剪这些来源。
新的整合历史摘录会保留替换条目的来源谱系,包括其合并或取代的父条目。只要这些摘录存在,其来源行就保留,即使在备份轮换之后也是如此。日记历史没有自动过期;长修订历史可能保留不断增长来源集合。
当回填将多个会话中的相同声明合并时,它会保留每个来源谱系,而不会将重复声明计为额外证据。会话回填日记行在发布前也会携带与来源谱系相关的标记。这包括 REM 事实、反思和合并声明,即使显示的引文被缩短或后续应用步骤失败。遗忘任何贡献会话都会移除整个标记行,而不是无关的日记行。较早未标记的回填日记不会追溯获得谱系。
覆盖并非普遍。手写笔记、直接智能体编辑以及在谱系跟踪之前暂存的条目可能缺少条目来源。报告的 untargetableEntryKeys 列出的是所选智能体存储中没有来源的提升标记,而不是所有未跟踪的文本。此类条目不能仅凭谱系来选择,尽管显式会话引用或精确的语料引用仍可能匹配文件擦洗。
准入:将来源排除在 memory 之外¶
为了让 Gmail hook 会话不进入 dreaming 摄取和会话回填:
{
plugins: {
entries: {
"memory-core": {
config: {
memoryPolicy: {
excludeSessions: {
hookExternalContentSources: ["gmail"],
},
},
},
},
},
},
}
IMAP 使用精确的 hook 来源 email;Gmail hooks 使用 gmail。同时包含这两个值以排除这两个来源。通用 webhooks 使用 webhook。
你也可以排除 channel/plugin 标识符(不是 room ID)或 chat 类型。空列表或省略的列表不会添加任何策略排除项。任一列表中的匹配都会排除整个会话;值匹配的是已记录的会话元数据,而不是对话中的词语。
两条路径都会在读取 transcript 之前检查策略。自动摄取还会在其摄取检查点中记录排除原因。删除匹配的规则会使会话有资格在后续扫描中被处理,但需满足其他信任和摄取门控。被记录为 forgotten 的会话仍保持排除。
策略是前瞻性的:它不会删除现有语料库、暂存候选项或已提升条目。对于现有可归属数据,请使用 memory forget。请参阅 Memory 配置 以了解精确匹配规则和排除原因。
准入边界¶
| 路径 | 已配置的准入排除项 |
|---|---|
| 自动 dreaming 摄取 | 在读取 transcript 之前应用 |
手动 session-backfill |
在 preview、REM 和 apply 模式中应用 |
| 原始 transcript 索引 | 不应用 |
| 直接写入和 session hooks | 不应用 |
匹配需要保留的会话元数据;缺失字段不会匹配规则。这两个控制都会遵循已配置的 session.store,包括自定义和共享存储,同时保持选择范围限定于所选 agent。较早的保留记录可能只有粗略的 webhook 分类;如果没有原始精确来源,OpenClaw 不会推断 email 或 webhook 用于匹配。请通过完整 ID 显式选择这些会话。
自动 dreaming 会单独跳过保留的归档。若也要将已归档会话排除在回填和 transcript 索引之外,请显式将其完整会话 ID 标记为 forgotten。这些路径会检查 forgotten-session 记录,即使原来的 channel、chat 类型或 hook-source 元数据已不可用。
被排除的会话如果其工具允许,仍可能编辑 MEMORY.md、USER.md 或其他 workspace 文件。当需要阻止这些写入时,请限制相关的 file、shell 和 external-harness 能力,并审查已启用的 memory-writing hooks。准入策略不是文件系统权限。观察到的写入会被报告以供审查,但不会提供逐条来源谱系。
删除:清除会话产生的内容¶
选择器标识的是会话,而不是关于某个人的单独事实。--participant 选择具有该已记录 actor ID 的会话;它不会在 memory 文本中搜索姓名。--hook-source 选择具有该已记录 external-content 来源的会话。两者都需要保留的元数据。显式 ID 和 keys 也可以解析保留的归档。
具有任一已选来源的受跟踪条目会被整体删除,即使它还具有未选中的来源。这些删除会出现在 mixedLineageEntryKeys 中。清除操作不会要求模型从合并后的文本中减去某个人的贡献。幸存的来源之后可能支持新条目,但不保证自动重建。
清理涵盖匹配的已提升条目、session-corpus 行、memory index chunks 及其全文/向量行、短期状态、摄取去重状态以及 dreaming rewrite preimages。非空的会话选择还会清除所选 agent 的整个 embedding 缓存,包括尚未链接到已发布 chunks 的未完成重建结果。无关的已发布索引条目仍可使用;后续索引可能需要重新生成缓存的 embeddings。试运行会报告此删除但不会应用它。
清除操作还会从扫描的 memory 文件和 dream 日记中删除包含精确选中 corpus 片段的整行。命令参考 描述了计数器和选择限制。
已清除的会话保持清除¶
真正的清除操作会在删除其产物之前,在所选 agent 的 SQLite 数据库中记录每个已选会话为 forgotten。自动摄取、历史会话回填和 transcript 索引(包括 memory index --force)都会检查这些记录。自动摄取会记录原因 forgotten。
transcript 更新仅针对已选会话检查 forgotten-session 成员资格。启动 catch-up、dreaming 和 backfill 会以有界批次检查其候选项,从而在整个选择范围内保留排除项。
memory 插件会将其暂存和文件变更与清除操作协调。如果待处理的 dream narrative 的受跟踪来源条目或先前 diary 上下文在发布前被删除,则会被跳过。这不会追溯识别旧 diary 条目中未跟踪的改写。带有引用标记的历史 consolidation highlights 也缺乏可靠的删除边界。当报告识别出该格式中剩余的 highlights 时,会在 refusals 中发出警告;请手动审查它们。该警告不是所有未跟踪历史的清单,缺失的历史来源谱系也不会被重建。
索引在发布 chunks 或缓存 embeddings 之前会再次检查,因此在清除操作之前准备好的结果无法恢复 forgotten 会话数据或过时的 memory-file 快照。受影响的索引运行会报告其来源已变更;重新运行 openclaw memory index --agent <agent-id> 以索引当前数据。
重复清除操作不会解除该排除。它适用于该 agent 存储中的那些会话 ID,而不是与同一人或同一 hook 来源的未来对话。请在准入边界内保留一条准入规则,用于未来匹配的会话。
删除不涵盖的内容¶
- 原始转录和归档。 记忆清理会将它们保留在会话存储中。会话删除 是 独立的生命周期操作,并且通常会保留已删除转录的归档。不要将任一命令视为所有会话副本 均已擦除的证明。
- 未跟踪的旧记忆。 没有来源行意味着无法进行基于谱系的删除。 新会话回填会保留来源,但不会追溯性地为候选项提供谱系,也不会重写在旧版本中丢失来源的 备份。请单独检查这些项;先前的清除不会自动修复。
- 自由格式编辑。
curatedWrites会报告带有relativePath和observedAt的已识别写入或写入 尝试。仅该记录本身不会删除文件,也不会识别贡献的行。受支持的写入/编辑/补丁 转录记录会补充最新的文件级观察器记录,但 可能包含未成功的尝试。任意 shell 写入和外部编辑 不会被完全跟踪。 - 转述和其他副本。 精确语料引用可以被移除, 但未跟踪的转述、导出、外部备份、其他插件的存储 以及独立复制的文件不在本次清理范围内。已报告的精选 文件仍可能丢失与受跟踪条目或精确引用匹配的行。
- 其他代理。 选择记录和已遗忘会话记录按代理划分。 请对每个相关代理重复审查,包括共享工作区的 代理;一个代理的报告并不能证明所有索引都是干净的。
空预览表示这些选择器和匹配规则没有再发现更多产物。 它不是没有相关信息残留的证明。
端到端清除某个人或某个来源¶
对于参与者,请先在每个相关代理中执行预览:
在移除 --dry-run 之前,请验证已解析的会话 ID。这会删除
从这些会话中的任何内容派生的受跟踪条目,而不仅仅是
该参与者撰写的消息。如果归档中缺少参与者元数据,
请添加其显式 --session <id-or-key> 选择器。
对于来源,请使用其记录的 hook 标识符:
应用已审查的选择后,请检查保留的文件和未跟踪 的记忆,分别处理转录和归档的保留,并重新运行预览。如果来自该来源的未来会话也应 排除在 dreaming 摄取和会话回填之外,请添加一条准入规则。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw