OpenClaw 八层记忆体系:从身份基线到技能进化的完整架构

深度解析 OpenClaw 八层记忆架构的安装、配置与协作机制——从即时层到后台层，让 AI Agent 拥有完整的记忆生命周期。

让 AI Agent 不只是"聊天机器人"，而是拥有身份、会话记忆、世界知识和技能进化能力的完整智能体。

我是 AI灵感闪现，使用 OpenClaw 小龙虾让 AI 自主管理工作和生活上的问题；使用 Claude Code + BMAD AI 驱动敏捷开发框架，让 AI 自主开发和交付软件来表达想法和灵感。是 MoneyMind 省钱思维 App 和 HeartPetBond 心宠纽带 App 开发者。正在实践和分享让 AI 自主解决健康、生活、投资和等方面的问题。我尽可能让 AI 自己完成从目标到交付以及演进的闭环，以最少的人为交互与监督，让 AI 自己跑流程。我只给 AI 想法或目标，全程不陪跑，让 AI 自主运行类似 Tesla FSD 自动驾驶。

版本环境： OpenClaw 2026.4.12 (1c0672b) 适用系统： macOS (Apple Silicon)

为什么需要分层记忆

单一记忆方案无法同时满足 AI Agent 的所有需求。身份偏好需要稳定注入、会话历史需要压缩存储、世界知识需要结构化检索、高价值洞察需要自动晋升。OpenClaw 的解决方案是分层架构——不同层负责不同时间尺度和信息类型，各司其职、互不重叠。

体系总览

┌─────────────────────────────────────────────────────────────────┐│                    即时层 (每次对话自动触发)                       ││                                                                 ││  L1 Active Memory    身份/基线偏好          → before_prompt_build││  L2 lossless-claw    当前会话压缩历史        → before_prompt_build││  L8 MemOS Local      主记忆层 + 技能进化     → before_prompt_build│├─────────────────────────────────────────────────────────────────┤│                    按需层 (Agent 主动调用)                        ││                                                                 ││  L5 GBrain           世界知识(人/公司/概念)   → gbrain search/get ││  L7 Wiki             编译后结构化知识         → wiki_search/get   │├─────────────────────────────────────────────────────────────────┤│                    后台层 (定时任务)                              ││                                                                 ││  L4 QMD              会话日志归档             → 内置自动          ││  L6 Dreaming         高层 insight 晋升       → cron 凌晨3点      ││  L5 GBrain Cron      实体扫描/同步           → cron 每15min/凌晨  ││  L3 LanceDB Pro      备用长期记忆层           → 当前停用          │└─────────────────────────────────────────────────────────────────┘

这套架构分为三大类：

即时层：每次对话自动注入，包括身份基线 (L1)、会话压缩 (L2)、主记忆与技能 (L8)
按需层：Agent 需要时主动查询，包括世界知识 (L5) 和编译文档 (L7)
后台层：定时任务驱动，包括日志归档 (L4)、记忆晋升 (L6)、实体同步 (L5 Cron)

各层详解

Layer 1: Active Memory — 身份基线

Active Memory 是最基础的一层，把 MEMORY.md 和近期日记文件注入到 prompt 中，提供身份认同、长期偏好和近期上下文。

Hook: before_prompt_build
核心文件: MEMORY.md + memory/YYYY-MM-DD.md
负责: 身份、稳定偏好、长期背景
不负责: 对话级自动记忆、技能演化

这一层是内置插件，无需额外安装。它就像人的"自我认知"——你知道自己是谁、喜欢什么、最近在做什么。

Layer 2: lossless-claw — 会话压缩

当对话超过模型上下文窗口时，默认行为是直接截断旧消息。lossless-claw 用 DAG 压缩替代了这种"遗忘"机制，保留可展开的回忆能力。

openclaw plugins install @martian-engineering/lossless-claw

Hook: before_prompt_build, session_end, before_reset
提供工具: lcm_grep、lcm_describe、lcm_expand_query
负责: 当前会话压缩历史
不负责: 跨会话长期记忆

Layer 3: memory-lancedb-pro — 备用长期记忆

原本作为长期语义记忆层，负责自动提取偏好、决策、经验教训。当前已停用，配置和数据完整保留，可随时切回。

停用原因：OpenClaw 的 plugins.slots.memory 只能选一个 kind: "memory" 插件，当前让位给了 MemOS Local。

Layer 4: QMD — 会话日志归档

系统底层的会话持久化，记录所有对话日志，也是 Dreaming 层的原料来源。

存储: ~/.openclaw/state/sessions/
负责: 原始会话归档
不负责: 直接 prompt 注入

Layer 5: GBrain — 世界知识库

负责人、公司、技术概念等实体级知识的结构化存储与检索。基于 PostgreSQL + pgvector。

gbrain search "query"gbrain get page-sluggbrain put page-slug

配合定时任务（每 15 分钟文件同步、每天实体扫描），持续维护世界知识的完整性。

Layer 6: Dreaming — 记忆晋升

从短期会话和 recall 记录中筛选高价值 insight，晋升到长期记忆文件。类似人类睡眠时的记忆巩固过程。

定时运行: 每天凌晨 3 点
当前状态: cron 超时待修

Layer 7: Wiki — 编译知识层

将知识编译成 Obsidian 风格的结构化文档视图，提供 wiki_search / wiki_get 工具供 Agent 按需查阅。

Layer 8: MemOS Local — 当前主记忆层

MemOS Local 是当前的主力记忆引擎，接管了 memory slot，开启完整能力：对话记忆、混合检索、任务总结、技能进化、自动 recall。

{"plugins":{"slots":{"memory":"memos-local-openclaw-plugin"}}}

使用本地 Ollama embedding (qwen3-embedding:8b-fp16) 和 summarizer (qwen3:32b)，数据存储在 SQLite 中，附带 Memory Viewer (端口 18799)。

安装关键步骤：必须在插件目录内单独安装 better-sqlite3，因为 Homebrew Node v25.9.0 非 LTS，缺预编译包，加上 npm hoisting 会把模块放错位置：

cd ~/.openclaw/extensions/node_modules/@memtensor/memos-local-openclaw-pluginnpm install better-sqlite3

数据流全景

用户消息到达  │  ├─ L1 Active Memory 注入身份/长期背景  ├─ L2 lossless-claw 注入压缩会话历史  ├─ L8 MemOS Local 注入相关记忆/任务/技能上下文  │  ▼Agent 响应  │  ├─ L8 MemOS Local 记录对话、更新记忆、推进技能演化  ├─ L2 lossless-claw 更新 DAG 压缩结构  ├─ L4 QMD 归档原始会话日志  │  ▼后台  │  ├─ L5 GBrain 定时同步显式知识  ├─ L6 Dreaming 选择高价值内容晋升  └─ L7 Wiki 编译结构化文档

各层去重分工

组件	负责什么	不负责什么
Active Memory	身份、长期背景、稳定偏好	自动任务记忆
lossless-claw	当前会话压缩	跨会话长期记忆
MemOS Local	主记忆、任务总结、技能进化	世界知识实体
QMD	原始会话归档	prompt recall
GBrain	实体知识	普通对话记忆
Dreaming	高价值 insight 晋升	在线记忆检索
Wiki	编译知识文档	主记忆层

踩坑记录

MemOS Local 与 memory-lancedb-pro 不可共存

OpenClaw plugins.slots.memory 只能选一个 memory plugin。kind: "memory" 的插件没拿到 slot 就会被禁用。这不是配置写法问题，而是核心设计限制。

better-sqlite3 的"编译失败"陷阱

表面上看是"老编译失败"，实际根因是三层问题叠加：

Homebrew Node v25.9.0 非 LTS，缺预编译包
触发本地 node-gyp 编译
npm hoisting 把模块放到顶层，插件找不到

修复关键：不是重试编译，而是在插件目录内单独 npm install better-sqlite3。

Gateway 的 Node 路径

Gateway LaunchAgent 实际用的是 /opt/homebrew/opt/node/bin/node，不是 asdf 的那套。调试时要注意路径一致性。

当前状态与路线图

阶段	事项	状态
安装 memory-lancedb-pro + Ollama embedding	✅ 完成
评估 MemOS Local vs memory-lancedb-pro	✅ 完成
切换到 MemOS Local 全功能模式	✅ 完成
修复 better-sqlite3 加载问题	✅ 完成
观察 MemOS Local 实际效果	🔄 进行中 (1-2 周)
修复 Dreaming cron 超时	待执行
调整 GBrain dream cycle	待执行
视效果决定是否切回 memory-lancedb-pro	待定