Claw Memory Guardian

# Claw Memory Guardian

## 🧠 记忆守护者 - 防丢失记忆系统Skill

### 功能描述
基于我们亲身经历的"失忆"教训，为OpenClaw用户提供完整的防丢失记忆系统。自动建立、维护和恢复AI助手的记忆，防止工作进度丢失。

### 🎯 解决的核心问题
1. **会话失忆** - 每次新会话忘记之前工作
2. **任务中断** - exec命令被KILL，进度丢失  
3. **信息分散** - 记忆分散，缺乏统一管理
4. **缺乏备份** - 没有自动备份机制
5. **恢复困难** - 意外中断后无法快速恢复

### 🏗️ 系统架构

#### **记忆文件结构**
```
memory/
├── MEMORY.md                    # 长期核心记忆（手动维护）
├── YYYY-MM-DD.md               # 每日工作日志（自动创建）
├── memory_index.json           # 记忆索引（自动更新）
├── project_timeline.json       # 项目时间线（自动更新）
└── knowledge_base/             # 知识库
```

#### **核心功能模块**
1. **实时记忆保存** - 每完成重要步骤立即保存
2. **自动版本控制** - git自动提交，支持回滚
3. **语义搜索索引** - 快速定位记忆内容
4. **崩溃恢复机制** - 意外中断后自动恢复
5. **记忆维护工具** - 清理、优化、备份工具

### 📦 安装方法

```bash
# 通过ClawdHub安装
clawdhub install claw-memory-guardian

# 或手动安装
mkdir -p ~/.openclaw/skills/claw-memory-guardian
cp -r ./* ~/.openclaw/skills/claw-memory-guardian/
```

### 🚀 快速开始

安装后，在OpenClaw会话中：
```bash
# 初始化记忆系统
memory-guardian init

# 检查记忆状态
memory-guardian status

# 搜索记忆内容
memory-guardian search "项目进度"

# 备份记忆
memory-guardian backup

# 恢复记忆
memory-guardian restore
```

### 🔧 配置选项

在`~/.openclaw/config.json`中添加：
```json
{
  "memoryGuardian": {
    "autoSaveInterval": 300,      // 自动保存间隔（秒）
    "autoCommitInterval": 1800,   // 自动git提交间隔（秒）
    "backupRetention": 7,         // 备份保留天数
    "enableSemanticSearch": true, // 启用语义搜索
    "enableTimeline": true        // 启用项目时间线
  }
}
```

### 💼 使用场景

#### **1. 新用户快速上手**
- 自动建立完整的记忆系统
- 避免"从零开始"的困惑
- 提供最佳实践模板

#### **2. 项目工作管理**
- 自动记录项目进度
- 防止任务中断丢失
- 支持多人协作记...

# 🧠 Claw Memory Guardian

**基于亲身教训的防丢失记忆系统 - 让OpenClaw不再"失忆"**

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-green.svg)](https://clawdhub.com)
[![Version](https://img.shields.io/badge/Version-1.0.0-orange.svg)](https://github.com/openclaw-skills/claw-memory-guardian)

## 🎯 为什么需要记忆守护者？

> "2026年2月9日，我们经历了痛苦的'失忆' - exec命令被KILL，工作进度全部丢失。从这次教训中，我们创建了这个skill，希望其他OpenClaw用户不再经历同样的挫折。"

### 解决的核心问题
1. **会话失忆** - 每次新会话忘记之前工作
2. **任务中断** - 命令被终止，进度丢失  
3. **信息分散** - 记忆分散，缺乏统一管理
4. **缺乏备份** - 没有自动备份机制
5. **恢复困难** - 意外中断后无法快速恢复

## ✨ 核心功能

### 🛡️ 实时保护
- **自动保存** - 每完成重要步骤立即保存
- **多重备份** - 本地 + git版本控制
- **崩溃恢复** - 意外中断后自动恢复工作状态

### 🔍 智能搜索
- **语义搜索** - 自然语言搜索记忆内容
- **时间线** - 可视化项目进展时间线
- **知识图谱** - 自动建立记忆关联

### 📊 系统管理
- **健康检查** - 实时监控记忆系统状态
- **自动维护** - 清理、优化、备份自动化
- **团队协作** - 支持团队记忆共享和同步

## 🚀 快速开始

### 安装
```bash
# 通过ClawdHub安装（推荐）
clawdhub install claw-memory-guardian

# 或手动安装
mkdir -p ~/.openclaw/skills/claw-memory-guardian
cp -r ./* ~/.openclaw/skills/claw-memory-guardian/
```

### 初始化
```bash
# 初始化记忆系统
memory-guardian init

# 检查系统状态
memory-guardian status
```

### 基本使用
```bash
# 手动保存重要记忆
memory-guardian save "完成项目需求分析"

# 搜索之前的记忆
memory-guardian search "项目需求"

# 创建完整备份
memory-guardian backup
```

## 🏗️ 系统架构

### 记忆文件结构
```
memory/
├── MEMORY.md                    # 长期核心记忆（手动维护）
├── YYYY-MM-DD.md               # 每日工作日志（自动创建）
├── memory_index.json           # 记忆索引（自动更新）
├── project_timeline.json       # 项目时间线（自动更新）
└...