OpenClaw 2.0 更新了啥给不想看技术文档的你

一句话结论

一句话版：最重要的变化Six Changes at a Glance

• 1网页界面从"工具箱"变成聊天软件——会话居中，其他功能都贴着对话放。
• 2它会记住以前聊过的事（内置记忆），下次不用重新交代背景。
• 3新装的时候能直接复用电脑上已有的 ChatGPT/Claude 订阅或本地模型，不用重新折腾。
• 4手机（iPhone/Android 等）有原生 App 了，能语音、传附件。
• 5安全审批更清楚：每一步操作"谁、在哪个会话、发的什么命令"都有记录。
• 6能把任务共享给队友，带着完整上下文交接，一起协作。

新功能清单按"对你最有感"排序

其他值得一提的新东西

内置记忆：详细说说Built-in Memory, in Detail

1它解决什么问题The Problem It Solves

会话一重置，之前交代的背景全忘——这是聊天记忆最烦的断点。内置记忆解决的就是跨会话 / 跨重置的连续性：官方明确说，它的命中可以覆盖“会话 reset 之后回想私人会话上下文”的场景（PR #122051）。

底座仍是文件式记忆：agent 把内容写成 workspace 里的普通 Markdown——根目录的 MEMORY.md、USER.md、带日期的 memory/YYYY-MM-DD.md、还有 DREAMS.md；检索时它只记得写进磁盘的内容，按官方说法，没有隐藏状态。

2谁默认能用Who Gets It by Default

“符合条件的个人安装”默认开启，判据落在一个配置项上：memory.search.rememberAcrossConversations，官方默认值是“个人安装开启；配置了 DM isolation 则关闭”。具体规则：未设置时，只有全局 session.dmScope 未设置或为 "main"、且没有任何 binding 用 session.dmScope 覆盖，才默认开启；任何已配置的 DM isolation 都会让它默认关闭；显式写的 true / false 永远优先。

范围收得很紧：回忆只发生在同一个 agent 的私密会话之间——groups、channels、shared aliases、其他 agent、已删除历史、被策略阻断的来源一律排除；正在回答的那个会话本身也不当来源；groups 与 channels 既不作来源也不作接收方；未知会话类型 fail closed（宁找不到，不放行）；沙箱化的 recall 不能借用这个跨会话授权。

前置条件：当前 memory provider 必须支持 protected private transcript recall，否则该设置会被跳过；openclaw doctor 会报告 provider 不支持、或 Active Memory 的 toolsAllow 漏掉 memory_search 的情况。

3工作机制How It Works

写盘 → 切块 → 入库 → 混合检索。索引把 MEMORY.md、已存在的根 USER.md、memory/*.md 按每块 400 tokens、重叠 80 tokens 切块，写进每个 agent 一个的 SQLite 库：~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite；文件一改动，1.5 秒防抖后自动重建索引。注意：这个库同库还放着会话历史和其他持久 agent 状态——别拿它当“记忆缓存”删（详见隐私边界）。

检索是混合（hybrid）：embedding 向量相似度 + BM25 关键词（FTS5 全文索引）并行、加权合并，再叠加时间衰减与重要性，最后用 MMR 去重（hybrid 结果默认启用）。排序大致是“相关度 × 时间衰减 × 重要性”：带日期的 daily notes 按30 天半衰期衰减，MEMORY.md / USER.md 则 evergreen（不衰减）；MMR 用 lambda 0.7 + Jaccard 相似度。

中文也支持：除了关键词，还能按文件名、完整或部分 Unicode 路径检索，中文 / 日文 / 韩文走 CJK trigram 分词；可选 sqlite-vec 加速（独立只读进程）。

降级规则：混合检索开箱可用（默认 OpenAI embeddings，有 OPENAI_API_KEY 即可）；没有 embedding provider 时，自动退化成只剩关键词搜索；显式指定的远端 provider 不可用时则 fail closed——报 unavailable，不静默降级。

对话里的自动注入：符合条件的回合会用触发短语比对，向隐藏上下文最多注入 3 条精简条目；但只有“已提升且可信”的条目才允许自动注入——在 provenance 生效前，仅限根 MEMORY.md 与 USER.md；daily notes、导入的 transcript、session transcript 永不自动注入，只能靠显式工具或 Active Memory 深挖通道拿到。

深挖通道（Active Memory）：默认 escalate 模式，只有消息明确问起过去、且确定性通道没有强可信命中时，才跑一次阻塞式 recall 子代理。

4你能做什么What You Can Do

• 1看状态：openclaw memory status；加 --deep 探测 vector store / embedding provider，--json 出机器可读。
• 2搜索：openclaw memory search "query"（可选 --agent / --max-results / --min-score）；Control UI 的 Memories 页展示同一批结果，带过期警告。
• 3重建索引：openclaw memory index --force --agent <id>——换了 provider / 模型后，索引身份不兼容、向量检索会暂停，需要显式重建。
• 4清空派生记忆：openclaw memory reset --agent <id> [--yes]——原子丢弃并重建仅 memory 自有的派生表；会话记录与源文件都保留，注意它不是隐私清除。
• 5遗忘：openclaw memory forget --agent <id> --session <id-or-key> | --participant <actor-id> | --hook-source <source>——默认立即删除，删除边界见隐私边界。
• 6导入：Control UI → Settings → Import Memory，可从 Codex / Claude Code / Hermes 导入记忆 Markdown（落在 memory/imports/<source>/，不并入启动用的 MEMORY.md，也不改源文件）；默认 agent 直接在 Ask OpenClaw 里说 import memory 也行。

5旧方案 QMD：退役与迁移QMD Retired

2.0 让内置记忆成为唯一的记忆引擎（官方 PR 就叫 “Retire QMD and use builtin memory exclusively”）。QMD 专属的三样能力被移除：学习型重排（learned cross-encoder reranking）、查询扩展（HyDE 生成）、跨 agent 转录搜索。内置的 MMR 只是确定性的去重，不是学出来的相关性重排；内置的查询扩展也只是有界的词法级扩展，不是模型级的。官方提醒：退役是“把数据带进另一个内核”，QMD-only 的语义不会自动等价恢复。

升级时跑 openclaw doctor --fix 迁移：删除已退役设置 memory.backend、memory.qmd、memory.search.qmd（含 agent 级）；把 QMD paths 与 extra collections 转成 memory.search.extraPaths 条目（带 { path, pattern } glob）。如果 QMD 的 session indexing 曾开启，会顺带开启 builtin session indexing、并把 sessions 加进 memory.search.sources——但不会因此开启更广的跨会话回忆；发现 ~/.openclaw/agents/<agentId>/qmd/ 目录时，Doctor 还会询问是否删除其中的派生索引、模型下载、collection 元数据与 session exports。

数据承诺：“cutover is lossless by construction”——canonical memory（MEMORY.md、USER.md、memory/*.md、迁移过来的 extra paths）既不复制、也不删除，只重建派生状态。但有三类数据会停下来等你修，不自动迁移：结构畸形（malformed structures）、向量维度不兼容、以及没有安全 owner 的数据。

原来 QMD 那种进程内、零 key 的本地 embedding，改用 @openclaw/llama-cpp-provider 并把 memory.search.provider 设为 "local"，否则只剩 BM25 关键词。LanceDB、Memory Wiki、外部 embedding 服务以及 MEMORY.md / USER.md 都还在，各有独立角色，没有退役。

6隐私边界Privacy Boundaries

跨会话回忆是只读的有界检索：它不合并各会话的 transcript，也不改变 session key、DM scope、路由、递送或 tools.sessions.visibility。每个索引块都带 provenance 元数据（来源分级 owner / agent / untrusted / system、会话类型、观测时间、可选的 supersession key），而且元数据与 Markdown 分开存储——被回忆的文本自己改不了它的信任分级。

删除走 openclaw memory forget：无确认提示、默认立即删除，只删可归属的派生记忆，并记录一笔“已遗忘”；原始 transcript 不删。--participant 按记录的 actor ID 选整个会话（含他人贡献），不是在文字里搜人名；条目只要命中任一被选来源就整条删。遗忘派生记忆既不会抹掉原始会话，也不覆盖 OpenClaw 之外的副本——改写过的自由文本、其他插件存储、外部备份都不在删除范围内。

想关掉：设 memory.search.rememberAcrossConversations: false（显式值优先），或配置 DM isolation 让它默认关闭；memory.search.enabled: false 则把记忆搜索整体关掉。

还有 incognito 旁路（仅 Control UI 新建会话可开）：会话内容只留在进程内存里，不跑自动记忆 flush、也不生成 transcript 归档；但显式要求保存或工具写文件仍可能落盘，配置的模型 provider 依然会处理消息。

7和 rewind / fork 是两条线Separate from Rewind

聊天能 rewind 回某条用户消息、fork 出新分支、在保留的分支间切换——但rewind 只改转录分支，不撤销文件、已发出的消息或工具副作用；记忆是另一条独立的线（还想办法覆盖“reset 之前刚重要的内容”），两者各管各的。

存疑What's Unverified

1. QMD 全称官方没写QMD acronym：现行官方文档未解释 “QMD” 的名称与内部实现；旧文档快照把它描述为 “Local-first sidecar with reranking, query expansion, and the ability to index directories outside the workspace”，但那一段在当前页面已不存在，只能算旁证。
2. 两处文档口径未统一Transcript indexing：rememberAcrossConversations 开启会“隐含启用 session transcript 索引”；而 /concepts/memory-search 仍把 session indexing 称为 opt-in（experimental.sessionMemory: true + sources 加 sessions）。两条路径的关系官方没有显式统一说明，并存待核。
3. 私人内容进共享记忆的路径Escalation path：“自动注入仅限已提升且可信条目”与“session 派生记忆可被 dreaming 提升”两条并存——私人会话内容进入共享 MEMORY.md 的完整路径，官方没有一张流程图讲清；需自行组合 admission policy + provenance 页面理解。

官方入口Official Docs

• 记忆总览 docs.openclaw.ai
  https://docs.openclaw.ai/concepts/memory 4 个记忆文件、工具、引擎、import、flush、dreaming
• 内置记忆引擎 docs.openclaw.ai
  https://docs.openclaw.ai/concepts/memory-builtin 默认 SQLite 引擎、索引、QMD 迁移、排障
• 混合检索与排序 docs.openclaw.ai
  https://docs.openclaw.ai/concepts/memory-search 混合检索、排序公式、MMR、session 检索
• 来源追踪（provenance） docs.openclaw.ai
  https://docs.openclaw.ai/concepts/memory-provenance lineage、admission policy、删除边界
• 配置项参考 docs.openclaw.ai
  https://docs.openclaw.ai/reference/memory-config 全部配置项，含 rememberAcrossConversations 默认规则
• CLI：记忆命令 docs.openclaw.ai
  https://docs.openclaw.ai/cli/memory status / index / reset / search / forget 等命令

升级前要留意：2.0 带来的"搬家"事项Before You Upgrade

2.0 改动很大，有三件"搬家"要心里有数（都是官方说明点名提醒的）：

你现在的情况Your Current State

不太确定的地方（如实交代）What We Didn't Verify

1. 2.0 的确切发布日期Release date：官方发布说明和博客都没写具体日期（博客只写 "Today"），本报告按版本号推断为 2026 年 8 月。
2. 官方数字对不上PR / contributors：发布说明写 16,977 个 PR、987 名贡献者；官方博客写约 16,000+ PR、933 名贡献者（其中 569 名首次贡献）。两处都是官方口径，但数字不一致。
3. 到底哪版算 2.0Version naming：官方只把 v2026.8.1 标注为 "OpenClaw 2.0"；网上有第三方帖子把 v2026.8.2 也叫 2.0，本报告未采用（v2026.8.2 的官方发布说明未冠名 2.0）。
4. 共享云会话的细节Shared sessions（配额、计费、部署方式）来自官方博客的亮点介绍，未进一步核实。
5. 本机功能未逐项实测Not tested：内置记忆、rewind/fork、PWA 审批通知等只在文档层面核实过。
6. 2.0 之后的新功能没调研Scope：2026.8.2～2026.9.5 之间的增量功能不在本次范围内；要看"最新版全貌"需要另查 v2026.9.5 发布说明。

资料来源均为官方一手来源

• 2.0 官方发布说明 docs.openclaw.ai
  https://docs.openclaw.ai/releases/2026.8.1 每项功能的细节见其下的对应子页面，如 /releases/2026.8.1/memory
• 官方博客（2.0 发布文） openclaw.ai
  https://openclaw.ai/blog/openclaw-2-accidentally
• GitHub 发布页 github.com
  https://github.com/openclaw/openclaw/releases "最新版为 2026.9.5"的出处
• 版本说明入口 docs.openclaw.ai
  https://docs.openclaw.ai/releases