Hippocampus Photon

"AI is meant to FIX human memory flaws, why learn human decay?"

Hooks & Automation

Note: OpenClaw hook system uses "hook packs" - may require manual setup.

For auto-save, use cron jobs (recommended) instead of session hooks.

Philosophy

Traditional memory = Human memory imitation = DECAY = WRONG

AI should FIX human memory flaws: - ❌ Forgetting → ✅ Perfect recall - ❌ Fuzzy matching → ✅ Precise timestamps
- ❌ Passive triggers → ✅ Proactive warnings - ❌ Importance decay → ✅ Never lose anything

Features

Setup (REQUIRED!)

After installing, you MUST run initialization:

cd /path/to/hippocampus
python3 scripts/memory.py init

This creates: - assets/hippocampus/chronicle/db.sqlite - assets/hippocampus/monograph/ - assets/hippocampus/index/

Then verify with:

python3 scripts/memory.py status

Cron Jobs (Required!)

Automatic memory saving requires cron jobs. User must confirm once:

# Auto-save every 6 hours
openclaw cron add --name "hippocampus-autosave" 
  --schedule "0 */6 * * *" 
  --session-target isolated 
  --payload "Run: python3 /path/to/scripts/memory.py autocheck"

# Daily at 7 AM
openclaw cron add --name "hippocampus-daily" 
  --schedule "0 7 * * *" 
  --session-target isolated 
  --payload "Run: python3 /path/to/scripts/memory.py new daily-YYYY-MM-DD"

# Daily analysis at 11 PM - analyze chronicle, promote to monograph
openclaw cron add --name "hippocampus-analyze" 
  --schedule "0 23 * * *" 
  --session-target isolated 
  --payload "Run: python3 /path/to/scripts/memory.py analyze"

Cron Jobs (Auto-created!)

When user runs "setup hippocampus" or "/photon setup", AI automatically creates:

1. hippocampus-autosave - Every 6 hours
2. hippocampus-daily - Daily at 7 AM
3. hippocampus-analyze - Daily at 11 PM

These cron jobs provide automatic memory saving (replaces session hooks).

Two Memory Types

Chronicle - Temporal memory for everyday interactions - Automatically saves session content - Indexed by time

Monograph - Important topics with rich metadata - Stores significant memories, decisions, preferences - Created via user request or auto-analysis

Monograph Creation

1. User Explicit:

python3 scripts/memory.py new "Important Topic"
python3 scripts/memory.py add "Key content..."

2. Auto-Analysis:

python3 scripts/memory.py analyze  # Examines chronicle, promotes to monograph

Keyword Index

• Auto-generated in index/ directory
• Each keyword creates a .md reference file
• Enables fast cross-topic search

Commands

• /photon status - View status
• /photon save - Save context
• /photon recall <query> - Recall
• /photon checkpoint - Save state
• /photon warn - Check patterns

Version

3.0.0 (Photon)