11 KiB
11 KiB
三层记忆系统实现
文档版本: v1.0
创建时间: 2026-02-13
作者: 青龙 (QingLong)
位置: /root/.openclaw/doc/
📋 目录
概述
目的
三层记忆系统是青龙的 长期记忆基础设施，用于：
| 功能 | 说明 |
|---|---|
| 身份持久化 | 核心身份、角色、原则 |
| 配置同步 | 系统配置、工具设置 |
| 知识沉淀 | 经验教训、最佳实践 |
| 规则约束 | 安全规则、强制约束 |
设计理念
| 理念 | 说明 |
|---|---|
| 分层存储 | 按重要性和使用频率分层 |
| 语义搜索 | 支持向量相似度搜索 |
| 自动化 | 每日自动存档、手动触发 |
| 持久化 | 磁盘存储，防内存丢失 |
架构设计
三层结构
┌─────────────────────────────────────────────────────────────────┐
│ 三层记忆架构 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 第一层：情景记忆 (高优先级) │ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ 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. 文件存储
存储格式
# [标题]
## 元信息
- 创建时间：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. 语义搜索
搜索命令
# 记忆搜索工具
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%文本 |
配置示例
{
"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. 向量数据库
数据库文件
/root/.openclaw/memory/main.sqlite
数据结构
| 表名 | 用途 |
|---|---|
| memories | 向量存储的记忆内容 |
| embeddings | 向量索引 |
| sessions | 会话历史 |
数据库大小
| 时间 | 大小 |
|---|---|
| 2026-02-13 | ~5MB |
4. 同步机制
自动同步
# 自动监控目录变化
memorySync:
watch: true
手动同步
# 强制同步
openclaw memory sync
5. 每日记忆生成
触发条件
| 条件 | 说明 |
|---|---|
| 定时任务 | 每日cron |
| 手动触发 | Agent完成重要任务 |
| 故障恢复 | 系统重启后 |
生成内容
# YYYY-MM-DD 记忆存档
## 今日完成
-
## 待办
-
## 重要发现
-
使用规范
1. 记忆创建流程
1. 确定类型 → 2. 选择目录 → 3. 按规范命名 → 4. 写入内容 → 5. 更新索引
2. 各层触发时机
| 层级 | 类型 | 触发时机 |
|---|---|---|
| 第一层 | 身份/配置/规则 | 系统初始化/配置变更/规则建立 |
| 第二层 | 知识/任务 | 经验沉淀/任务创建 |
| 第三层 | 每日记忆 | 每日自动/重要任务完成 |
3. 编写规范
第一层 (不可修改)
# 核心身份
## 基础信息
- 代号：青龙 🐉
- 角色：主机器人
## 原则
- 诚实为本
- 执行优先
第二层 (AI可生成)
# 华强北发布协议
## 背景
...
## 核心要点
1. ...
## 经验教训
...
第三层 (自动生成)
# 2026-02-13 记忆存档
## 今日完成
- 完成了X任务
## 待办
- 待办Y任务
4. 审核流程
| 层级 | 审核人 | 方式 |
|---|---|---|
| 第一层 | 人工 | 用户确认 |
| 第二层 | 人工+AI | AI草稿，人工审核 |
| 第三层 | AI | 自动生成 |
查询方法
1. 快速读取
# 直接读取文件
memory_get [path]
# 示例
memory_get /root/.openclaw/memory/01-identity/identity.md
memory_get /root/.openclaw/memory/02-config/agents.md
2. 语义搜索
# 关键词搜索
memory_search [关键词]
# 示例
memory_search Telegram
memory_search 记忆系统
memory_search 诚实原则
3. 手动浏览
# 列出所有记忆
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 |
恢复方法
# 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