memory-organizer

# Memory Organizer Skill

Organize memory with a strict two-layer model.

## Core Rule

Treat `MEMORY.md` as a small permanent index.

Do not copy every dated memory file into `MEMORY.md`.
Do not turn daily logs into permanent memory.
Keep historical details inside `memory/YYYY-MM-DD.md` files unless a fact is clearly long-lived and should be loaded in every new session.

## Memory Model

### 1. Permanent memory: `MEMORY.md`

Keep only information that is worth reading every session:

- Stable user preferences
- Durable identity or relationship facts
- Long-lived project configuration
- Important workspace rules
- Cross-session todos that are still active
- Reusable operational facts that will matter again

This file should stay short, clean, deduplicated, and easy to scan.

### 2. Daily memory: `memory/YYYY-MM-DD.md`

Keep session-specific and historical detail here:

- Daily work logs
- Intermediate reasoning summaries
- One-off experiments
- Temporary debugging notes
- Daily outcomes and progress notes
- Detailed records that are useful later, but not required every session

When compressing or organizing memory, preserve these files instead of moving everything into permanent memory.

## Decision Rule: Promote or Keep Local

Before writing anything into `MEMORY.md`, ask:

1. Will this likely matter across many future sessions?
2. Does it need to be loaded immediately at session start?
3. Is it stable enough that it will not create clutter soon?

Only promote the item when the answer is clearly yes.

If the item is useful mainly as history, context, or audit trail, keep it in the dated file.

## What to Promote

Promote only concise bullets such as:

- User prefers short paragraphs and punchy style
- Workspace path or permission boundary that must always be respected
- Current active project rule that affects future execution
- Ongoing todo that spans multiple days

## What Not to Promote

Do not promote these by default:

- Full daily summaries
- Per-day changel...

# Memory Organizer

[English](#english) | [中文](#中文)

---

## English

### Description
Organize OpenClaw memory with a clean two-layer strategy. Keep `MEMORY.md` small and durable, while preserving daily details inside `memory/YYYY-MM-DD.md` files.

### What it does
- Compress dated memory files without losing historical structure
- Remove duplication and noise from permanent memory
- Keep permanent memory focused on must-read facts
- Avoid copying every daily memory into `MEMORY.md`

### Permanent vs daily memory

**Keep in `MEMORY.md`:**
- Stable user preferences
- Durable project configuration
- Workspace rules
- Active cross-session todos

**Keep in `memory/YYYY-MM-DD.md`:**
- Daily summaries
- Work logs
- Debugging details
- Temporary notes
- Historical progress records

### Installation
```bash
npx clawhub install memory-organizer
```

### Usage
```bash
# Scan memory files
node memory-organizer.js scan

# Compress one dated memory file in place
node memory-organizer.js compress 2026-03-08.md

# Selectively promote durable facts only
node memory-organizer.js merge 2026-03-08.md
```

### Rule
Do not merge every dated memory file into permanent memory. Promote only durable facts that should be loaded at the start of future sessions.

---

## 中文

### 描述
用干净的双层结构整理 OpenClaw 记忆。让 `MEMORY.md` 保持精简稳定，把每天的细节继续留在 `memory/YYYY-MM-DD.md` 里。

### 功能
- 压缩每日记忆文件，但保留历史结构
- 清理永久记忆中的重复和噪音
- 让永久记忆只保留必须长期读取的信息
- 避免把每天的记忆都复制进 `MEMORY.md`

### 永久记忆和每日记忆的边界

**适合放进 `MEMORY.md` 的内容：**
- 稳定的用户偏好
- 长期有效的项目配置
- 工作区规则
- 跨会话仍然有效的待办

**适合留在 `memory/YYYY-MM-DD.md` 的内容：**
- 每日总结
- 工作日志
- 调试细节
- 临时笔记
- 历史进展记录

### 安装
```bash
npx clawhub install memory-organizer
```

### 使用
```bash
# 扫描记忆文件
node memory-organizer.js scan

# 原地压缩某天的记忆文件
node memory-organizer.js compress 2026-03-08.md

# 只提炼长期...