Auto Memory Keeper
Overview
Automatically extract session content and update daily memory files to maintain long-term memory continuity.
Two modes:
- Passive mode: Cron job runs hourly (automatic)
- Active mode: Manual trigger by user ("remember this", "log today")
How It Works
Triggers
- Auto-trigger: Cron job runs every hour
- Manual trigger: User says "remember this", "log today", "update memory"
Workflow
Step 1: Check Environment
DATE=$(date +%Y-%m-%d)
MEMORY_FILE=~/.openclaw/workspace/memory/${DATE}.md
if [ ! -f "$MEMORY_FILE" ]; then
echo "# ${DATE} Log\n\n## Today's Items\n\n- " > "$MEMORY_FILE"
fi
Step 2: Fetch Recent Sessions
# Use sessions_list to get active sessions in last 60 minutes
# Use sessions_history to get session details
Step 3: Noise Filtering
Skip these message types:
- Simple greetings ("hi", "hello", "hey")
- Acknowledgments ("thanks", "ok", "sure", "yes")
- Single word responses
- Questions without context
- HEARTBEAT_OK messages
- System messages
Step 4: Extract Key Info
From filtered messages, extract:
| Type | Keywords | Format |
|---|---|---|
| Decision | "decided", "chose", "adopted" | - {time} {decision} |
| Task | new feature, new config, new task | - {time} {task description} |
| Progress | "completed", "finished", "installed" | - {time} completed {task} |
| Issue | error, bug, failed | - {time} issue: {description} |
| Conclusion | summary, conclusion, finding | - {time} {conclusion} |
Step 5: Smart Deduplication
Check for duplicates before recording:
# Read current file content
# If similar content exists (>80% similarity), skip
# Otherwise append
Step 6: Update Memory File
Format:
## Today's Items
- {time} {item description}
- {time} {item description}
...
Examples
Input (user message):
"installed openclaw-tavily-search, score 3.639"
Stored:
- 21:47 installed openclaw-tavily-search skill (score 3.639)
Input (user message):
"auto-extract session content to memory file every hour"
Stored:
- 21:50 created auto-memory-keeper skill for hourly auto memory extraction
Configuration
Configurable via config.json:
{
"memory_dir": "~/.openclaw/workspace/memory",
"interval_hours": 1,
"active_minutes": 60,
"categories": ["Decision", "Task", "Progress", "Issue", "Conclusion"],
"skip_patterns": ["^hi", "^hello", "^thanks", "^ok"],
"dedup_threshold": 0.8
}
Quality Rules
- Concise - One sentence per item
- Timestamp - Always include time
- Dedupe - Avoid duplicate entries
- Categorize - Classify by type
- Skip noise - Don't record trivial messages
FAQ
Q: How to trigger manually? A: Say "remember this", "log today", or "update memory"
Q: Where is cron configured?
A: Use cron job add command, see example in SKILL.md
Q: Where are memory files stored?
A: ~/.openclaw/workspace/memory/YYYY-MM-DD.md
Testing
Periodically review memory files and adjust skip_patterns for better filtering.
Related
- Works well with
session-wrap-up(manual vs auto trigger) - Complex memories can be manually written to
MEMORY.md(long-term)