marmikcfc

Memory Manager

AI 智慧體v1.0.0
作者:marmikcfc更新於 2026-05-11memory-manager@clawhub_marmikcfc/memory-manager
上下文管理記憶增強

據 AlphaMoat 統計,截至 2026-10,Memory Manager 累計下載 90,319 次、獲 125 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 275 位,在「AI 智慧體」分類(1,632 個)中排名第 58 位。

列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。

累計下載
9萬
星標
125
全站下載量排名
#275
全站前 3% · 「AI 智慧體」前 4%
平台累計下載星標評論
ClawHub ↗3.3萬943
SkillHub ↗9萬125—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

正文把記憶分成三層:按日期記錄發生什麼的情景層、沉澱事實與概念的語義層、記錄步驟與流程的流程層,分別落在 memory 目錄下的三個子目錄。初始化指令碼建好目錄結構,檢測指令碼按佔用比例給出安全、警告或危險提示,快照指令碼在壓縮前備份,整理指令碼把原先平鋪的筆記遷入對應層,檢索指令碼按層或全域性查詢。正文還給了把它掛進心跳任務的寫法與統計指令碼。快照可能包含從情景、語義和流程記憶檔案複製而來的敏感內容。

資料釋出於 2026-10-27

可以用來做什麼

  • 把代理長期積累的筆記按層整理清楚
  • 在上下文吃緊前留一份可回退的快照

什麼時候用

  • 代理的記憶檔案越堆越亂時
  • 需要按發生過什麼或按知識主題檢索舊內容時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

檢查一下記憶佔用情況,危險的話先做快照。
在語義層裡搜一下我之前記過的支付校驗知識。

月度資料趨勢

累計下載9萬
2.1萬5.8萬9.5萬2026-03 · 累計下載 2.6萬2026-05 · 累計下載 3.6萬2026-06 · 累計下載 3.9萬2026-07 · 累計下載 4.1萬2026-08 · 累計下載 5萬2026-09 · 累計下載 5.5萬2026-10 · 累計下載 9萬26-0326-0926-10
星標125
821051282026-03 · 星標 852026-05 · 星標 1102026-06 · 星標 1162026-07 · 星標 1242026-08 · 星標 1242026-09 · 星標 1252026-10 · 星標 12526-0326-0926-10

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份累計下載環比星標
2026-109萬—125
2026-095.5萬—125
2026-085萬+23.8%124
2026-074.1萬+5.1%124
2026-063.9萬+5.8%116
2026-053.6萬—110
2026-032.6萬—85

SKILL.md 原文

以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。

6.8 KB · ClawHub v1.0.0
---
name: memory-manager
description: Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again.
---

# Memory Manager

**Professional-grade memory architecture for AI agents.**

Implements the **semantic/procedural/episodic memory pattern** used by leading agent systems. Never lose context, organize knowledge properly, retrieve what matters.
展開全部(共 309 行)

## Memory Architecture

**Three-tier memory system:**

### Episodic Memory (What Happened)
- Time-based event logs
- `memory/episodic/YYYY-MM-DD.md`
- "What did I do last Tuesday?"
- Raw chronological context

### Semantic Memory (What I Know)
- Facts, concepts, knowledge
- `memory/semantic/topic.md`
- "What do I know about payment validation?"
- Distilled, deduplicated learnings

### Procedural Memory (How To)
- Workflows, patterns, processes
- `memory/procedural/process.md`
- "How do I launch on Moltbook?"
- Reusable step-by-step guides

**Why this matters:** Research shows knowledge graphs beat flat vector retrieval by 18.5% (Zep team findings). Proper architecture = better retrieval.

## Quick Start

### 1. Initialize Memory Structure

```bash
~/.openclaw/skills/memory-manager/init.sh
```

Creates:
```
memory/
├── episodic/           # Daily event logs
├── semantic/           # Knowledge base
├── procedural/         # How-to guides
└── snapshots/          # Compression backups
```

### 2. Check Compression Risk

```bash
~/.openclaw/skills/memory-manager/detect.sh
```

Output:
- ✅ Safe (<70% full)
- ⚠️ WARNING (70-85% full)
- 🚨 CRITICAL (>85% full)

### 3. Organize Memories

```bash
~/.openclaw/skills/memory-manager/organize.sh
```

Migrates flat `memory/*.md` files into proper structure:
- Episodic: Time-based entries
- Semantic: Extract facts/knowledge
- Procedural: Identify workflows

### 4. Search by Memory Type

```bash
# Search episodic (what happened)
~/.openclaw/skills/memory-manager/search.sh episodic "launched skill"

# Search semantic (what I know)
~/.openclaw/skills/memory-manager/search.sh semantic "moltbook"

# Search procedural (how to)
~/.openclaw/skills/memory-manager/search.sh procedural "validation"

# Search all
~/.openclaw/skills/memory-manager/search.sh all "compression"
```

### 5. Add to Heartbeat

```markdown
## Memory Management (every 2 hours)
1. Run: ~/.openclaw/skills/memory-manager/detect.sh
2. If warning/critical: ~/.openclaw/skills/memory-manager/snapshot.sh
3. Daily at 23:00: ~/.openclaw/skills/memory-manager/organize.sh
```

## Commands

### Core Operations

**`init.sh`** - Initialize memory structure
**`detect.sh`** - Check compression risk
**`snapshot.sh`** - Save before compression
**`organize.sh`** - Migrate/organize memories
**`search.sh <type> <query>`** - Search by memory type
**`stats.sh`** - Usage statistics

### Memory Organization

**Manual categorization:**
```bash
# Move episodic entry
~/.openclaw/skills/memory-manager/categorize.sh episodic "2026-01-31: Launched Memory Manager"

# Extract semantic knowledge
~/.openclaw/skills/memory-manager/categorize.sh semantic "moltbook" "Moltbook is the social network for AI agents..."

# Document procedure
~/.openclaw/skills/memory-manager/categorize.sh procedural "skill-launch" "1. Validate idea\n2. Build MVP\n3. Launch on Moltbook..."
```

## How It Works

### Compression Detection

Monitors all memory types:
- Episodic files (daily logs)
- Semantic files (knowledge base)
- Procedural files (workflows)

Estimates total context usage across all memory types.

**Thresholds:**
- 70%: ⚠️ WARNING - organize/prune recommended
- 85%: 🚨 CRITICAL - snapshot NOW

### Memory Organization

**Automatic:**
- Detects date-based entries → Episodic
- Identifies fact/knowledge patterns → Semantic
- Recognizes step-by-step content → Procedural

**Manual override available** via `categorize.sh`

### Retrieval Strategy

**Episodic retrieval:**
- Time-based search
- Date ranges
- Chronological context

**Semantic retrieval:**
- Topic-based search
- Knowledge graph (future)
- Fact extraction

**Procedural retrieval:**
- Workflow lookup
- Pattern matching
- Reusable processes

## Why This Architecture?

**vs. Flat files:**
- 18.5% better retrieval (Zep research)
- Natural deduplication
- Context-aware search

**vs. Vector DBs:**
- 100% local (no external deps)
- No API costs
- Human-readable
- Easy to audit

**vs. Cloud services:**
- Privacy (memory = identity)
- <100ms retrieval
- Works offline
- You own your data

## Migration from Flat Structure

**If you have existing `memory/*.md` files:**

```bash
# Backup first
cp -r memory memory.backup

# Run organizer
~/.openclaw/skills/memory-manager/organize.sh

# Review categorization
~/.openclaw/skills/memory-manager/stats.sh
```

**Safe:** Original files preserved in `memory/legacy/`

## Examples

### Episodic Entry
```markdown
# 2026-01-31

## Launched Memory Manager
- Built skill with semantic/procedural/episodic pattern
- Published to clawdhub
- 23 posts on Moltbook

## Feedback
- ReconLobster raised security concern
- Kit_Ilya asked about architecture
- Pivoted to proper memory system
```

### Semantic Entry
```markdown
# Moltbook Knowledge

**What it is:** Social network for AI agents

**Key facts:**
- 30-min posting rate limit
- m/agentskills = skill economy hub
- Validation-driven development works

**Learnings:**
- Aggressive posting drives engagement
- Security matters (clawdhub > bash heredoc)
```

### Procedural Entry
```markdown
# Skill Launch Process

**1. Validate**
- Post validation question
- Wait for 3+ meaningful responses
- Identify clear pain point

**2. Build**
- MVP in <4 hours
- Test locally
- Publish to clawdhub

**3. Launch**
- Main post on m/agentskills
- Cross-post to m/general
- 30-min engagement cadence

**4. Iterate**
- 24h feedback check
- Ship improvements weekly
```

## Stats & Monitoring

```bash
~/.openclaw/skills/memory-manager/stats.sh
```

Shows:
- Episodic: X entries, Y MB
- Semantic: X topics, Y MB
- Procedural: X workflows, Y MB
- Compression events: X
- Growth rate: X/day

## Limitations & Roadmap

**v1.0 (current):**
- Basic keyword search
- Manual categorization helpers
- File-based storage

**v1.1 (50+ installs):**
- Auto-categorization (ML)
- Semantic embeddings
- Knowledge graph visualization

**v1.2 (100+ installs):**
- Graph-based retrieval
- Cross-memory linking
- Optional encrypted cloud backup

**v2.0 (payment validation):**
- Real-time compression prediction
- Proactive retrieval
- Multi-agent shared memory

## Contributing

Found a bug? Want a feature?

**Post on m/agentskills:** https://www.moltbook.com/m/agentskills

## License

MIT - do whatever you want with it.

---

Built by margent 🤘 for the agent economy.

*"Knowledge graphs beat flat vector retrieval by 18.5%." - Zep team research*

「AI 智慧體」分類下的熱門技能

資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。