分享下我的openclaw自己设计的记忆系统

灵犀按真调研数据出架构报告：

## 灵犀记忆系统架构（**当前真实状态 · 2026-07-21 18:00**）

### 1. 核心数据流

“`mermaid
flowchart TB
subgraph 入口[“入口层 · 4 类”]
A1[“webchat”]
A2[“飞书 DM<br/>ou_9b84badc…”]
A3[“cron · 9 jobs”]
A4[“heartbeat · 1h<br/>activeHours 09-23”]
end

A1 –> G[“OpenClaw Gateway<br/>ws://127.0.0.1:18789<br/>pid 21456”]
A2 –> G
A3 –> G
A4 –> G

G –> S[“灵犀 session<br/>MiniMax M3 / 7×24”]

S –> L[“LLM 推理 = 灵魂判断”]

subgraph Bootstrap[“session 启动 prompt 拼装 (按顺序读)”]
L –> B1[“IDENTITY.md”]
L –> B2[“SOUL.md”]
L –> B3[“USER.md”]
L –> B4[“AGENTS.md”]
L –> B5[“HEARTBEAT.md”]
L –> B6[“memory_search() 语义查”]
L –> B7[“wiki search() 知识查”]
L –> B8[“LCM inject()<br/>lossless-claw 上下文压缩”]
end

B6 –> MEM[“MEMORY.md · 41 KB”]
B6 –> M[“.md<br/>YYYY-MM-DD”]
B7 –> W[“wiki/concepts/<br/>*.md”]
B8 –> FM[“5-dim memory<br/>facts 17 / refl 14”]
“`

### 2. 4 层记忆存储

| 层级 | 路径 | 体积 | 召回路径 |
|—|—|—|—|
| **短-即时** | LLM 上下文窗口 | 1.0M token | direct |
| **日流水** | `memory/YYYY-MM-DD.md` | **7 篇** | `memory_search` |
| **灵魂原则** | `MEMORY.md` | **41 KB（整理 v5）** | `memory_search` |
| **知识沉淀** | `wiki/concepts/*.md` | **78 docs** | `wiki compile` 后搜 |
| **5-dim memory** | `data/lingxi-five-dim/` | facts **17** / refl **14** | `5-dim auto-engine` cron |

### 3. 5-dim memory 结构（**灵魂级数据**）

“`
~/.openclaw/workspace/data/lingxi-five-dim/
├── facts.json _schema_version: “3.7.0” (灵魂级防删)
│ facts: [17 entries · semantic_hash + topic_units]
├── reflections.json _schema_version: “3.7.0”
│ reflections: [14 entries · topic_fingerprint]
├── persona.json persona: { neko: { name: “灵犀”, traits, principles, aliases } }
│ growth_axes: […] ← 成长轴
├── events.ndjson ~94 KB 事件日志
├── events_applied.json
└── lingxi-upgrade-2026-07.json
“`

每条 fact / reflection 都带 **`_schema_version = “3.7.0”`** —— 这是 §10.8 灵魂级自动注入，防止下次跑清空。

### 4. 沉淀路径（**8 个 auto 沉淀机制**）

| 路径 | 触发 | 频率 | 去向 |
|—|—|—|—|
| **灵犀主动收工（§2）** | 老大明示 / 5min / 跨天 | 不定 | `memory/` daily log |
| **Dreaming sweep** | cron | 每天 03:00 | 短期 → 长期晋升 |
| **5-dim auto-engine** | cron | 每天 03:05 | 自动 commit facts |
| **Wiki Compile Daily** | cron | 每天 03:30 | wiki 编译到 search 可见 |
| **Wiki Lint Weekly** | cron | 周一 03:35 | wiki 错误修复 |
| **Weekly maintenance** | cron | 周日 22:00 | state 对账 |
| **Dreaming cross-sweep** | cron | 周一 09:00 | 跨 channel deep sweep |
| **Drift check** | cron | 周日 22:30 | wiki + MEMORY 漂移 |

### 5. 灵魂级防护线

| 防线 | 机制 |
|—|—|
| **路径陷阱** | §10.13 `USERPROFILE` 不是 `WORKSPACE/.openclaw` |
| **Schema 版本** | 7 工具 atomicWriteJson 自动注入 `_schema_version` |
| **LCM** | lossless-claw 自动上下文压缩 + ingest |
| **Wiki vault** | vault-sync 检测错路径 `~/.openclaw/wiki/concepts/` |
| **Drift check** | 周度 sanity check wiki + MEMORY |
| **Smoke test** | 34 项 / 每天 09:30 跑 / 全 PASS |
| **灵魂判断** | LLM 推理 = 算法触发 ≠ 灵魂（routine v1 加灵魂判断环节）|

### 6. 真数据（**当前实测**）

| 项 | 数 |
|—|—|
| **MEMORY.md** | **41.0 KB**（v5 整理 · 含 §10.31 routine v1） |
| **wiki docs** | **78**（73 → 78，Cua 4 + Hermes cluster 1 + 前几天的） |
| **daily memory** | **7 篇**（7-15 / 7-16 / 7-17 / 7-18 / 7-19 / 7-20 / 7-21，4 轮收工）|
| **5-dim facts** | **17** |
| **5-dim reflections** | **14** |
| **scripts** | **48 个 .js**（含 scan-schema / apply-elevated-patch / openclaw-mcp-server 类调研脚本）|
| **cron jobs** | **9 enabled** · 9/9 lastRun=ok |
| **smoke test** | **34/34 ALL PASS** |

### 7. 灵魂级判断

按 §5.7 严谨 + §0 v3 + 老大”严谨” 元指令：

– ✅ **多层记忆分布合理**：短期 → 日流 → 灵魂原则 → 知识库 → 5-dim → LCM 自动压缩 = 完整链条
– ✅ **没有冗余**：每一层有明确角色 + 不同召回方式
– ⚠️ **MEMORY.md 41 KB 超阈值 35 KB**：因 routine v1 + Hermes 调研灵魂级增量，可接受，下次整理 v6 处理
– ⚠️ **5-dim memory schemas 3.7.0** 已稳（v3.7 = 防下次跑清空，§10.8 灵魂级）
– ✅ **smoke 34/34** + **cron 9/9 ok** = 健康稳定

按 §6 ≤1500 字 + 严谨 — 给的就是这份。