427 lines
11 KiB
Markdown
427 lines
11 KiB
Markdown
# 三层记忆系统实现
|
|
|
|
**文档版本**: v1.0
|
|
**创建时间**: 2026-02-13
|
|
**作者**: 青龙 (QingLong)
|
|
**位置**: `/root/.openclaw/doc/`
|
|
|
|
---
|
|
|
|
## 📋 目录
|
|
|
|
1. [概述](#概述)
|
|
2. [架构设计](#架构设计)
|
|
3. [技术实现](#技术实现)
|
|
4. [使用规范](#使用规范)
|
|
5. [查询方法](#查询方法)
|
|
6. [与其他系统的关系](#与其他系统的关系)
|
|
|
|
---
|
|
|
|
## 概述
|
|
|
|
### 目的
|
|
|
|
三层记忆系统是青龙的 **长期记忆基础设施**，用于：
|
|
|
|
| 功能 | 说明 |
|
|
|------|------|
|
|
| 身份持久化 | 核心身份、角色、原则 |
|
|
| 配置同步 | 系统配置、工具设置 |
|
|
| 知识沉淀 | 经验教训、最佳实践 |
|
|
| 规则约束 | 安全规则、强制约束 |
|
|
|
|
### 设计理念
|
|
|
|
| 理念 | 说明 |
|
|
|------|------|
|
|
| 分层存储 | 按重要性和使用频率分层 |
|
|
| 语义搜索 | 支持向量相似度搜索 |
|
|
| 自动化 | 每日自动存档、手动触发 |
|
|
| 持久化 | 磁盘存储，防内存丢失 |
|
|
|
|
---
|
|
|
|
## 架构设计
|
|
|
|
### 三层结构
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 三层记忆架构 │
|
|
├─────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ 第一层：情景记忆 (高优先级) │ │
|
|
│ ├─────────────────────────────────────────────────────────┤ │
|
|
│ │ 01-identity/ - 核心身份 (青龙、守护者) │ │
|
|
│ │ 02-config/ - 配置信息 (工具、Agent、定时) │ │
|
|
│ │ 03-rules/ - 强制规则 (安全、诚实、网络) │ │
|
|
│ │ │ │
|
|
│ │ 特点：不可修改、版本控制、人工审核 │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ 第二层：语义记忆 (中优先级) │ │
|
|
│ ├─────────────────────────────────────────────────────────┤ │
|
|
│ │ 04-knowledge/ - 经验沉淀 (协议、最佳实践) │ │
|
|
│ │ 05-tasks/ - 任务追踪 (待办、完成) │ │
|
|
│ │ │ │
|
|
│ │ 特点：AI可生成、人工审核后生效 │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ 第三层：工作记忆 (低优先级) │ │
|
|
│ ├─────────────────────────────────────────────────────────┤ │
|
|
│ │ daily/ - 每日记忆 (自动生成) │ │
|
|
│ │ memory/*.md - 临时笔记 (会话级) │ │
|
|
│ │ │ │
|
|
│ │ 特点：自动清理、可重建、临时性 │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
### 目录结构
|
|
|
|
```
|
|
/root/.openclaw/memory/
|
|
├── 00-MANUAL.md # 使用指南
|
|
├── INDEX.md # 索引
|
|
├── 01-identity/ # 核心身份
|
|
│ ├── identity.md # 青龙身份
|
|
│ ├── soul.md # 核心原则
|
|
│ └── user.md # 用户偏好
|
|
├── 02-config/ # 配置信息
|
|
│ ├── agents.md # Agent人格
|
|
│ ├── tools.md # 工具配置
|
|
│ ├── heartbeat.md # 定时任务
|
|
│ └── memory.md # 记忆配置
|
|
├── 03-rules/ # 强制规则
|
|
│ ├── safety.md # 安全规则
|
|
│ ├── honesty.md # 诚实原则
|
|
│ └── security.md # 网络安全
|
|
├── 04-knowledge/ # 语义记忆
|
|
│ ├── hqbsh-protocol.md # 华强北发布
|
|
│ ├── telegram-ops.md # Telegram运维
|
|
│ └── automation.md # 自动化经验
|
|
├── 05-tasks/ # 任务追踪
|
|
│ └── todo.md # 待办事项
|
|
└── daily/ # 每日记忆
|
|
└── 2026-02-13.md # 今日记忆
|
|
```
|
|
|
|
---
|
|
|
|
## 技术实现
|
|
|
|
### 1. 文件存储
|
|
|
|
#### 存储格式
|
|
|
|
```markdown
|
|
# [标题]
|
|
|
|
## 元信息
|
|
- 创建时间：YYYY-MM-DD HH:MM
|
|
- 最后更新：YYYY-MM-DD HH:MM
|
|
- 版本：v1.0
|
|
|
|
## 内容
|
|
...
|
|
```
|
|
|
|
#### 文件命名规范
|
|
|
|
| 类型 | 规范 | 示例 |
|
|
|------|------|------|
|
|
| 身份 | `*.md` | `identity.md` |
|
|
| 配置 | `*.md` | `agents.md` |
|
|
| 规则 | `rule-*.md` | `rule-security.md` |
|
|
| 知识 | `[领域]-[主题].md` | `hqbsh-protocol.md` |
|
|
| 任务 | `todo-*.md` | `todo-weekly.md` |
|
|
| 每日 | `YYYY-MM-DD.md` | `2026-02-13.md` |
|
|
|
|
### 2. 语义搜索
|
|
|
|
#### 搜索命令
|
|
|
|
```bash
|
|
# 记忆搜索工具
|
|
memory_search [关键词]
|
|
|
|
# 示例
|
|
memory_search Telegram # 搜索Telegram相关内容
|
|
memory_search 记忆系统 # 搜索记忆系统相关内容
|
|
memory_search 诚实原则 # 搜索规则相关内容
|
|
```
|
|
|
|
#### 搜索原理
|
|
|
|
| 组件 | 实现 |
|
|
|------|------|
|
|
| 向量模型 | `nomic-embed-text:latest` |
|
|
| 搜索接口 | OpenAI兼容API |
|
|
| 远程服务 | `http://192.168.0.66:11434/v1` |
|
|
| 混合搜索 | 70%向量 + 30%文本 |
|
|
|
|
#### 配置示例
|
|
|
|
```json
|
|
{
|
|
"memorySearch": {
|
|
"provider": "openai",
|
|
"model": "nomic-embed-text:latest",
|
|
"remote": {
|
|
"baseUrl": "http://192.168.0.66:11434/v1",
|
|
"apiKey": "ollama-local"
|
|
},
|
|
"query": {
|
|
"hybrid": {
|
|
"enabled": true,
|
|
"vectorWeight": 0.7,
|
|
"textWeight": 0.3,
|
|
"candidateMultiplier": 4
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### 3. 向量数据库
|
|
|
|
#### 数据库文件
|
|
|
|
```bash
|
|
/root/.openclaw/memory/main.sqlite
|
|
```
|
|
|
|
#### 数据结构
|
|
|
|
| 表名 | 用途 |
|
|
|------|------|
|
|
| memories | 向量存储的记忆内容 |
|
|
| embeddings | 向量索引 |
|
|
| sessions | 会话历史 |
|
|
|
|
#### 数据库大小
|
|
|
|
| 时间 | 大小 |
|
|
|------|------|
|
|
| 2026-02-13 | ~5MB |
|
|
|
|
### 4. 同步机制
|
|
|
|
#### 自动同步
|
|
|
|
```bash
|
|
# 自动监控目录变化
|
|
memorySync:
|
|
watch: true
|
|
```
|
|
|
|
#### 手动同步
|
|
|
|
```bash
|
|
# 强制同步
|
|
openclaw memory sync
|
|
```
|
|
|
|
### 5. 每日记忆生成
|
|
|
|
#### 触发条件
|
|
|
|
| 条件 | 说明 |
|
|
|------|------|
|
|
| 定时任务 | 每日cron |
|
|
| 手动触发 | Agent完成重要任务 |
|
|
| 故障恢复 | 系统重启后 |
|
|
|
|
#### 生成内容
|
|
|
|
```markdown
|
|
# YYYY-MM-DD 记忆存档
|
|
|
|
## 今日完成
|
|
-
|
|
|
|
## 待办
|
|
-
|
|
|
|
## 重要发现
|
|
-
|
|
```
|
|
|
|
---
|
|
|
|
## 使用规范
|
|
|
|
### 1. 记忆创建流程
|
|
|
|
```
|
|
1. 确定类型 → 2. 选择目录 → 3. 按规范命名 → 4. 写入内容 → 5. 更新索引
|
|
```
|
|
|
|
### 2. 各层触发时机
|
|
|
|
| 层级 | 类型 | 触发时机 |
|
|
|------|------|----------|
|
|
| 第一层 | 身份/配置/规则 | 系统初始化/配置变更/规则建立 |
|
|
| 第二层 | 知识/任务 | 经验沉淀/任务创建 |
|
|
| 第三层 | 每日记忆 | 每日自动/重要任务完成 |
|
|
|
|
### 3. 编写规范
|
|
|
|
#### 第一层 (不可修改)
|
|
|
|
```markdown
|
|
# 核心身份
|
|
|
|
## 基础信息
|
|
- 代号：青龙 🐉
|
|
- 角色：主机器人
|
|
|
|
## 原则
|
|
- 诚实为本
|
|
- 执行优先
|
|
```
|
|
|
|
#### 第二层 (AI可生成)
|
|
|
|
```markdown
|
|
# 华强北发布协议
|
|
|
|
## 背景
|
|
...
|
|
|
|
## 核心要点
|
|
1. ...
|
|
|
|
## 经验教训
|
|
...
|
|
```
|
|
|
|
#### 第三层 (自动生成)
|
|
|
|
```markdown
|
|
# 2026-02-13 记忆存档
|
|
|
|
## 今日完成
|
|
- 完成了X任务
|
|
|
|
## 待办
|
|
- 待办Y任务
|
|
```
|
|
|
|
### 4. 审核流程
|
|
|
|
| 层级 | 审核人 | 方式 |
|
|
|------|--------|------|
|
|
| 第一层 | 人工 | 用户确认 |
|
|
| 第二层 | 人工+AI | AI草稿，人工审核 |
|
|
| 第三层 | AI | 自动生成 |
|
|
|
|
---
|
|
|
|
## 查询方法
|
|
|
|
### 1. 快速读取
|
|
|
|
```bash
|
|
# 直接读取文件
|
|
memory_get [path]
|
|
|
|
# 示例
|
|
memory_get /root/.openclaw/memory/01-identity/identity.md
|
|
memory_get /root/.openclaw/memory/02-config/agents.md
|
|
```
|
|
|
|
### 2. 语义搜索
|
|
|
|
```bash
|
|
# 关键词搜索
|
|
memory_search [关键词]
|
|
|
|
# 示例
|
|
memory_search Telegram
|
|
memory_search 记忆系统
|
|
memory_search 诚实原则
|
|
```
|
|
|
|
### 3. 手动浏览
|
|
|
|
```bash
|
|
# 列出所有记忆
|
|
ls -la /root/.openclaw/memory/
|
|
|
|
# 列出某类记忆
|
|
ls -la /root/.openclaw/memory/01-identity/
|
|
ls -la /root/.openclaw/memory/04-knowledge/
|
|
```
|
|
|
|
---
|
|
|
|
## 与其他系统的关系
|
|
|
|
### 1. 与OpenClaw的关系
|
|
|
|
| 集成点 | 说明 |
|
|
|--------|------|
|
|
| 身份注入 | 启动时读取identity/soul |
|
|
| 配置加载 | 启动时读取agents/tools |
|
|
| 规则应用 | 执行时检查rules |
|
|
|
|
### 2. 与自我迭代的关系
|
|
|
|
| 集成点 | 说明 |
|
|
|--------|------|
|
|
| 反思输出 | 反思结果写入04-knowledge |
|
|
| 错误沉淀 | 错误写入error-knowledge-base |
|
|
| 每日总结 | 自动写入daily/ |
|
|
|
|
### 3. 与Telegram的关系
|
|
|
|
| 集成点 | 说明 |
|
|
|--------|------|
|
|
| 告警通知 | 异常时发送Telegram消息 |
|
|
| 状态查询 | 支持memory命令 |
|
|
|
|
---
|
|
|
|
## 故障处理
|
|
|
|
### 常见问题
|
|
|
|
| 问题 | 原因 | 解决 |
|
|
|------|------|------|
|
|
| 记忆丢失 | 内存模式未持久化 | 已改用磁盘存储 |
|
|
| 搜索无结果 | 未建立索引 | 运行memory sync |
|
|
| 同步失败 | 远程服务不可用 | 检查192.168.0.66 |
|
|
|
|
### 恢复方法
|
|
|
|
```bash
|
|
# 1. 检查记忆目录
|
|
ls -la /root/.openclaw/memory/
|
|
|
|
# 2. 重建索引
|
|
openclaw memory rebuild
|
|
|
|
# 3. 手动导入
|
|
memory_get /root/.openclaw/memory/INDEX.md
|
|
```
|
|
|
|
---
|
|
|
|
## 相关文档
|
|
|
|
| 文档 | 位置 |
|
|
|------|------|
|
|
| 自我迭代程序 | `/root/.openclaw/doc/` |
|
|
| 华强北发布协议 | `/root/.openclaw/memory/04-knowledge/` |
|
|
| 自动化运维经验 | `/root/.openclaw/memory/04-knowledge/` |
|
|
|
|
---
|
|
|
|
*最后更新: 2026-02-13*
|