🏗️ Kiến Trúc Memory 3 Tầng cho AI Agents – Best Practices từ OpenClaw

💡 Dành cho: Ai đang làm việc với AI agents và muốn tổ chức memory khoa học, tránh mất dữ liệu và tối ưu hiệu suất.

📚 Mục Lục

• 🌟 Giới Thiệu
• 🤔 Vấn Đề: Memory vs Context
• 🏗️ Kiến Trúc 3 Tầng
• 📋 Tầng 1: Agent-Specific Memory
• 📅 Tầng 2: Daily Logs
• 📊 Tầng 3: Topic-Based Files
• 🔄 Workflow Hoạt Động
• 🧹 Auto-Cleanup System
• 📊 So Sánh: Trước vs Sau
• ✅ Best Practices
• 🔧 Implementation Guide
• 🎓 Tổng Kết

🌟 Giới Thiệu

🤔 Vấn Đề Thường Gặp

✅ Sau Khi Đọc Bài Này

🔍 Vấn Đề: Memory vs Context – Khác Nhau Như Thế Nào?

📖 Context (Ngữ cảnh)

• Tính chất: Tạm thời, như RAM của máy tính
• Lưu ở: Sessions (cuộc trò chuyện hiện tại)
• Tồn tại: Chỉ trong phiên làm việc
• Mất khi: Session kết thúc hoặc bị cleanup
• Dung lượng: Giới hạn (ví dụ: 200k tokens)

🧠 Memory (Trí nhớ)

• Tính chất: Lâu dài, như Hard Drive
• Lưu ở: Files .md trên disk
• Tồn tại: Vĩnh viễn (trừ khi xóa thủ công)
• Không giới hạn: Có thể lưu bao nhiêu tùy thích

🏗️ Kiến Trúc 3 Tầng: Giải Pháp Của Chuyên Gia

┌─────────────────────────────────────────────┐
│           KIẾN TRÚC 3 TẦNG                  │
└─────────────────────────────────────────────┘

📁 TẦNG 1: Agent-Specific Memory
   └── agents/[agent-name]/agent/MEMORY.md
       ├── Identity & purpose
       ├── User preferences
       └── Quick reference

📁 TẦNG 2: Daily Logs (Shared)
   └── workspace/memory/YYYY-MM-DD.md
       ├── Session summaries
       ├── Decisions made
       └── Tasks completed

📁 TẦNG 3: Topic-Based Files
   └── workspace/memory/[topic].md
       ├── Deep knowledge
       ├── Procedures
       └── Best practices

📋 Tầng 1: Agent-Specific Memory

📍 Vị trí

agents/[agent-name]/agent/MEMORY.md

🎯 Mục đích

Lưu identity & preferences của từng agent riêng biệt

📝 Lưu gì?

• Tên, purpose, nhiệm vụ agent
• User preferences cho agent này
• Quick reference facts
• Links đến resources

✅ Ví Dụ

# MEMORY - Main Agent

## USER PROFILE
- Name: user@gmail.com
- Timezone: GMT+7
- Style: Thích giải thích thực tế, không dùng table

## AGENT IDENTITY  
- Purpose: General AI assistant
- Model: Claude Sonnet 4.5
- Tools: Full access

## QUICK FACTS
- Server IP: 180.93.47.149
- n8n: https://n8n.example.com
- ClipProxy: localhost:8317

📅 Tầng 2: Daily Logs

📍 Vị trí

workspace/memory/YYYY-MM-DD.md

🎯 Mục đích

Ghi lại những gì xảy ra mỗi ngày, shared across all agents

📝 Lưu gì?

• Session summaries
• Decisions made today
• Errors encountered & fixed
• Important conversations
• Tasks completed

✅ Ví Dụ

# Daily Log - 2026-03-16

## Summary
Triển khai memory architecture, switched model to Sonnet

## Key Activities
- Created 3-tier memory system
- Configured auto-cleanup (14 days)
- User approved expert recommendations

## Decisions
- Sessions retention: 14 days default, 30 days for main
- Auto-summary before deletion
- Monthly topic consolidation

## Next Steps
- [ ] Import n8n workflows
- [ ] Configure phu-thuy agent
- [ ] Test auto-cleanup

📊 Tầng 3: Topic-Based Files

📍 Vị trí

workspace/memory/[topic].md

🎯 Mục đích

Tổng hợp kiến thức theo chủ đề

📝 Lưu gì?

• Deep dive vào 1 topic
• Lessons learned
• Procedures & configs
• Troubleshooting guides

✅ Ví Dụ Topics

• adspower-automation.md
• facebook-automation.md
• n8n-workflows.md
• server-infrastructure.md

🔄 Workflow: Memory Hoạt Động Như Thế Nào?

WORKFLOW:

1️⃣ User hỏi câu mới
   ↓
2️⃣ Agent search memory (nếu cần)
   → memory_search("topic")
   → Tìm trong daily logs + topic files
   ↓
3️⃣ Agent trả lời dựa trên:
   - Context hiện tại (session)
   - Memory tìm được
   - Knowledge của model
   ↓
4️⃣ Cuối session:
   → Tự động extract summary
   → Ghi vào daily log (YYYY-MM-DD.md)
   ↓
5️⃣ Sau 30 ngày:
   → Consolidate vào topic files (manual review)

CLEANUP:

Sessions:
├─ Keep 14 ngày (default agents)
├─ Keep 30 ngày (main agent)
├─ Auto-delete cũ hơn
└─ Extract summary trước khi xóa

Daily Logs:
└─ Keep forever ✅

Topic Files:
└─ Keep forever ✅
└─ Manual update khi cần

🧹 Auto-Cleanup System

🔧 Script Cleanup

#!/bin/bash
# cleanup-sessions.sh - Chạy hàng ngày 3 AM

DAYS_TO_KEEP=14
MAIN_AGENT_DAYS=30

# Cleanup default agents (14 days)
find ~/.openclaw/agents/*/sessions \
  -name "*.jsonl" -mtime +${DAYS_TO_KEEP} \
  ! -path "*/main/*" -delete

# Cleanup main agent (30 days)
find ~/.openclaw/agents/main/sessions \
  -name "*.jsonl" -mtime +${MAIN_AGENT_DAYS} -delete

# Cleanup deleted markers (7 days)
find ~/.openclaw/agents/*/sessions \
  -name "*.deleted.*" -mtime +7 -delete

echo "$(date): Cleanup completed" >> logs/cleanup.log

⏰ Cron Job

# Add to crontab
0 3 * * * ~/.openclaw/scripts/cleanup-sessions.sh

📊 So Sánh: Trước vs Sau

Tiêu Chí	❌ TRƯỚC (Messy)	✅ SAU (Clean)
Memory location	2 nơi (memory/ và workspace/memory/)	1 nơi (workspace/memory/)
Sessions cleanup	Không biết khi nào bị xóa	Auto-cleanup 14-30 days
Organization	Không có topic files	Topic-based (4 files)
Agent MEMORY.md	Quá dài, khó đọc	Concise (1-2 trang)
Maintenance	Manual, không consistent	Automated daily
Search	Khó, không biết tìm ở đâu	Dễ, theo ngày hoặc topic

✅ Best Practices

🎯 NÊN LÀM

🚫 KHÔNG NÊN

🔧 Implementation Guide

Bước 1: Tạo Structure

mkdir -p ~/.openclaw/workspace/memory
mkdir -p ~/.openclaw/workspace/docs
mkdir -p ~/.openclaw/scripts

Bước 2: Tạo Agent MEMORY.md

# MEMORY - Main Agent

## USER PROFILE
- Name: [your-email]
- Timezone: [your-tz]

## AGENT IDENTITY
- Purpose: [agent-purpose]
- Model: [model-name]

## QUICK FACTS
- Key info 1
- Key info 2

## REFERENCES
- Daily logs: workspace/memory/YYYY-MM-DD.md
- Topics: workspace/memory/[topic].md

Bước 3: Setup Cleanup Script

# Copy script
chmod +x ~/.openclaw/scripts/cleanup-sessions.sh

# Add cron
crontab -e
# Add: 0 3 * * * ~/.openclaw/scripts/cleanup-sessions.sh

Bước 4: Tạo First Daily Log

cat > ~/.openclaw/workspace/memory/$(date +%Y-%m-%d).md <<'EOF'
# Daily Log - $(date +%Y-%m-%d)

## Summary
Implemented 3-tier memory architecture

## Activities
- Created memory structure
- Setup auto-cleanup
- First daily log

## Next Steps
- [ ] Monitor cleanup effectiveness
- [ ] Create topic files as needed
EOF

🎓 Tổng Kết

📌 Key Takeaways

🔗 Resources

• 📖 OpenClaw Documentation
• 💬 Telegram Support
• 📧 Email: namvuhvq@gmail.com

---

📅 Version: 1.0 | Last updated: 2026-03-16
🎉 Chúc bạn thành công với Memory Architecture! 🚀