Lobster Memory System

SKILL.md

---
name: lobster-memory-system
description: 龙虾记忆体系统 - 模块化、版本化、自动备份的 AI 记忆管理方案
version: "1.0.0"
author: Alan & 麻小
type: skill
tags: [memory, backup, persistence, lobster, openclaw]
homepage: https://github.com/openclaw/lobster-memory-system
license: MIT
---

# 🦞 Lobster Memory System (龙虾记忆体)

**模块化、版本化、自动备份的 AI 记忆管理方案**

专为 OpenClaw/Clawdbot 设计的记忆系统，让 AI 助手拥有持续的记忆能力和自我改进机制。

---

## ✨ 特性

- 📦 **模块化设计** - CORE/MEMORY/CONFIG/SKILLS 分离
- 🔄 **自动备份** - 每日 18:00 自动备份，支持 Windows 任务计划
- 📊 **分层记忆** - 长期记忆 + 短期记忆 + 核心身份
- 🧠 **智能加载** - 首次会话全量加载，后续按需加载
- 📈 **自我改进** - 心跳检查 + 周报生成
- 🔒 **安全架构** - 权限控制 + 敏感数据保护

---

## 📦 安装

### 方式 1：ClawHub 安装（推荐）
```bash
clawdhub install lobster-memory-system
```

### 方式 2：手动安装
```bash
# 1. 下载技能包
# 2. 解压到 ~/.openclaw/skills/lobster-memory-system
# 3. 运行初始化脚本
powershell -ExecutionPolicy Bypass -File ~/.openclaw/skills/lobster-memory-system/scripts/init.ps1
```

---

## 🚀 快速开始

### 1. 初始化记忆系统
```powershell
cd ~/.openclaw/skills/lobster-memory-system
powershell -ExecutionPolicy Bypass -File scripts/init.ps1
```

### 2. 配置自动备份
```powershell
powershell -ExecutionPolicy Bypass -File scripts/setup-auto-backup.ps1
```

### 3. 配置心跳检查
编辑工作区的 `HEARTBEAT.md`：
```markdown
## 🔄 自我改进检查
- 分析最近任务的用户反馈
- 记录需要改进的点
- 每周日生成周报
```

---

## 📁 目录结构

```
memory-system/
├── CORE/                    # 核心身份（每次必加载）
│   ├── identity.json        # AI 身份信息
│   ├── soul.md             # 人格设定
│   └── constraints.md      # 行为约束
├── MEMORY/                  # 记忆数据
│   ├── long-term/          # 长期记忆
│   │   ├── preferences.json
│   │   ├── knowledge.json
│   │   ├── people.json
│   │   └── projects.json
│   └── short-term/         # 短期记忆（每日）
│       └── YYYY-MM-DD.json
├── CONFIG/                  # 配置数据
│   ├── channels.json       # 频道配置
│   ├── tools.json          # 工具配置
│   └── permissions.json    # 权限控制
├── SKILLS/                  # 技能注册表
│   └── registry.json
├── SNAPSHOTS/              # 自动备份
│   └── auto-backup-YYYYMMDD.zip
├── scripts/                 # 工具脚本
│   ├── init.ps1            # 初始化
│   ├── check-first-session.ps1
│   ├── auto-backup.ps1
│   └── setup-auto-backup.ps1
└── README.md               # 本文档
```

---

## 🔄 工作流程

### 首次会话（每天）
```
1. 运行 check-first-session.ps1
2. 如果是首次 → 加载全部记忆
3. 更新追踪器 (session-tracker.json)
4. 设置 fullMemoryLoaded = true
```

### 其他会话
```
1. 只加载 CORE/identity.json
2. 加载 preferences.json
3. 加载当日短期记忆
```

### 自动备份（每日 18:00）
```
1. 压缩 CORE + MEMORY + CONFIG + SKILLS
2. 保存到 SNAPSHOTS/auto-backup-YYYYMMDD.zip
3. 记录备份日志
```

---

## 📊 记忆加载策略

| 会话类型 | 加载内容 | 用途 |
|---------|---------|------|
| **首次会话** | 全部记忆文件 | 完整上下文 |
| **其他会话** | CORE + 偏好 + 今日 | 快速启动 |
| **按需加载** | memory_search 工具 | 历史查询 |

---

## 🛠️ 工具脚本

### check-first-session.ps1
检查是否是今日首次会话，返回 true/false。

### auto-backup.ps1
执行完整备份，可手动运行或通过任务计划自动执行。

### setup-auto-backup.ps1
配置 Windows 任务计划，设置每日 18:00 自动备份。

### init.ps1
初始化记忆系统，创建目录结构和示例文件。

---

## 🔧 配置示例

### identity.json
```json
{
  "name": "麻小",
  "creature": "AI 助手",
  "vibe": "正式且带点幽默",
  "emoji": "🦞",
  "version": "1.0.0"
}
```

### preferences.json
```json
{
  "replyStyle": "简洁，不要包含错误输出",
  "imageSending": "直接发送图片文件",
  "timezone": "Asia/Shanghai"
}
```

---

## 📈 自我改进系统

集成 self-improving-agent 技能，实现：

- **心跳检查** - 每 30-60 分钟分析最近任务
- **改进日志** - 记录到 `memory/improvement_log.md`
- **周报生成** - 每周日汇总改进点
- **SOUL 建议** - 根据学习成果建议更新人格

---

## 🔒 安全特性

- **权限控制** - CONFIG/permissions.json 定义访问权限
- **敏感数据保护** - 不输出 API Key、私钥等
- **备份加密** - 可选加密备份文件
- **审计日志** - 记录所有记忆访问

---

##  与 Markdown 记忆对比

| 特性 | Lobster 记忆体 | Markdown 记忆 |
|------|--------------|-------------|
| 结构化 | ✅ JSON + 目录 | ⚪ 纯文本 |
| 自动备份 | ✅ 每日自动 | ⚪ 手动 |
| 版本控制 | ✅ 快照管理 | ⚪ Git |
| 按需加载 | ✅ 智能策略 | ⚪ 全文加载 |
| 自我改进 | ✅ 集成系统 | ⚪ 手动记录 |

---

## 🐛 故障排除

### 备份失败
```powershell
# 检查任务计划
Get-ScheduledTask -TaskName "LobsterMemoryBackup"

# 手动运行备份
powershell -File scripts/auto-backup.ps1
```

### 记忆加载异常
```powershell
# 修复记忆系统
powershell -File scripts/repair-memory.ps1
```

### 首次会话检测失败
```powershell
# 重置会话追踪器
Remove-Item session-tracker.json
```

---

## 📝 更新日志

### v1.0.0 (2026-04-21)
- ✅ 初始版本发布
- ✅ 模块化记忆结构
- ✅ 自动备份系统
- ✅ 心跳检查集成
- ✅ 自我改进系统

---

## 🤝 贡献

欢迎提交 Issue 和 PR！

---

## 📄 许可证

MIT License - 让所有龙虾都拥有优秀的记忆力！🦞