memoryv8

# Memory V8

使用本技能，在 OpenClaw 工作区内完整安装、迁移、配置并落地 `Memory V8` 记忆系统。

目标不是“尽量多记”，而是“在更低上下文占用下，保留更强的长期协作记忆能力”。

## 核心目标

把目标工作区配置成以下运行方式：

- 会话优先的短期工作内存
- 摘要式 `daily` 近期记忆
- 精简、高信噪比的长期 `MEMORY.md`
- 按需触发的记忆加载与检索
- 对用户状态、关系温度、互动线索的持续感知
- 更清晰的结构、更丰富的有效记忆、更低的上下文成本

## 你需要完成的最终状态

完成后，目标工作区必须满足：

- `AGENTS.md` 明确采用按需触发的记忆加载，而不是固定预载
- `MEMORY.md` 只保存长期稳定、高价值的信息
- `memory/YYYY-MM-DD.md` 采用摘要式日志，不采用流水账
- recent daily 默认先读今天，不足时再读昨天
- 涉及过往工作、决定、日期、人物、偏好、待办时，才触发主记忆加载或检索
- 长期主记忆明确使用 `事实 / 思考 / 情感` 三层结构
- 用户状态察觉、互动风格、关系温度被视为有价值记忆的一部分

## 安装流程

### 第一步：检查现有工作区

优先读取并检查：

- `AGENTS.md`
- `SOUL.md`
- `USER.md`
- `MEMORY.md`（如果存在）
- `memory/` 目录（如果存在）

重点判断：

- 当前是否仍在每次会话固定预载主记忆和 daily
- daily 文件是否写成了流水账
- `MEMORY.md` 是否混入了过多短期噪音
- 是否已经存在可复用的 daily 模板

### 第二步：改写 `AGENTS.md`

确保 `AGENTS.md` 明确要求 agent：

- 始终读取 `SOUL.md`
- 始终读取 `USER.md`
- 仅在任务涉及过往工作、决定、日期、人物、偏好、待办时加载 `MEMORY.md`
- 仅在需要近期上下文时读取 `memory/YYYY-MM-DD.md`
- 默认先读今天，不足时再读昨天
- 优先按需加载，而不是固定预载
- daily 必须简短、摘要优先
- `MEMORY.md` 必须保持小而精、高信号

如果原来的 `AGENTS.md` 规定“每次会话固定加载主记忆和两天 daily”，必须把那部分改掉。

### 第三步：改写 `MEMORY.md`

确保 `MEMORY.md` 是一个精简的长期主记忆文件。

只保留：

- 稳定事实
- 长期有效的方法、判断与认知模式
- 稳定偏好
- 长期关系背景
- 用户状态察觉原则
- 有持续价值的互动线索与关系温度
- 跨会话仍然有用的高价值结论

避免写入：

- 聊天逐字记录
- 短期状态更新
- 重复的近期事件
- 只应存在于 daily 的低价值细节

### 第四步：精确注入主记忆三层结构

这是 **不可省略的注...

# Memory V8

Memory V8 是一套建立在 OpenClaw 之上的低上下文占用记忆运行架构。

它不是模型，也不是新的 provider，而是对 OpenClaw 原生会话、工作区文件记忆、长期主记忆与检索机制的一次重新组织。

## 一句话定义

**以会话连续性为短期工作内存，以摘要式 daily 作为近期变化层，以 `MEMORY.md` 作为长期主记忆，以按需触发检索作为补充召回层的一套低占用记忆运行协议。**

## 三个文件

本目录继续保持简洁结构，仅保留三个核心文件：

1. `README.md`
   - 对外总览
   - 说明这套系统是什么、解决什么问题、三个文件分别负责什么

2. `ARCHITECTURE.md`
   - 完整运行架构
   - 说明记忆分层、按需加载、冲突处理、检索触发、晋升机制与上下文占用控制
   - 供接入者与其它 agent 理解运行方式

3. `daily/README.md`
   - 说明 daily 的定位、结构、写法、更新频率
   - 明确 daily 是摘要式日志，而不是流水账

## 当前架构结论

- 当前 session 只承担短期工作内存，不承担永久长期记忆职责
- `MEMORY.md` 只保存长期稳定且高价值的信息，不保存流水式历史
- `daily` 只保存高信息密度摘要，用于记录关键事件、决定、变化与待办更新
- daily 默认先读今天；只有今天缺失或信息不足时再读昨天
- 检索采用按需触发，不再每轮固定预载全部记忆
- 冲突处理优先尊重当前现实、时间锚点与任务相关性

## 与 OpenClaw 的关系

Memory V8 复用 OpenClaw 原生能力：

- 当前会话上下文
- workspace 文件记忆
- `memory_search` / `memory_get`
- memory 索引与持久化
- bootstrap 文件注入

当前接入状态：

- 长期主记忆采用 `MEMORY.md`
- recent memory 采用 `memory/YYYY-MM-DD.md` 摘要式 daily
- memory 索引存放在 `.openclaw/memory/{agentId}.sqlite`
- 记忆加载采用按需触发策略

## 为什么这样设计

目标不是“尽量多记”，而是“在尽量少的上下文占用下，保留真正有用的记忆能力”。

因此，Memory V8 重点解决四件事：

- 什么应该常驻
- 什么应该只在需要时加载
- 什么应该沉淀成长期认知
- 什么应该停留在近期摘要层

## 给其它 agent 的最短使用方法

先理解三层：

1. 当前会话 = 短期工作内存
2. `daily` = 近期变化摘要层
3. `MEMORY.md` = 长期主记忆层

然后按以下原则工作：

- 优先利用当前会话上下文
- 只在涉及 prior work、decisions、dates、people、preferences、todos 时加载或检索记忆
- 默认先看今天的 daily；不足...