Architecture Reference

Memory Architecture
Complete Diagrams

Visual reference for the three-layer Jarvis-like memory system. Redis buffer, Markdown logs, and Qdrant vector database working together.

System Architecture Overview

0

Session Context (OpenClaw Gateway)

Temporary Only

Session JSONL → Live Context

Lost on /reset or session expiration • ~8k-32k tokens

1

Redis Buffer (Fast Short-Term)

Real-Time

Key: mem:rob

List data structure • LPUSH append

Flush: Daily 3:00 AM

cron_backup.py → Qdrant

hb_append.py save_mem.py mem:rob
2

Daily File Logs (.md)

Persistent

Location: memory/YYYY-MM-DD.md

Human-readable Markdown

Git-tracked

Never lost • Always accessible

sliding_backup.sh 3:30 AM daily
3

Qdrant Vector DB (Semantic Long-Term)

Searchable

Embeddings

snowflake-arctic-embed2
1024 dimensions

Collections

kimi_memories
kimi_kb
private_court_docs

User-Centric

user_id: "rob"
Cross-session search

auto_store.py search_memories.py q

Data Flow & Automation

Real-Time

User Input → AI Response ↓ Redis Buffer (fast) ↓ File Log (persistent) ↓ [Optional: save q] → Qdrant

Every message triggers automatic append to Redis and file log.

Heartbeat

Every 30-60 min: hb_append.py → New turns hb_check_email.py → Gmail heartbeat_worker.py → Tasks

Periodic checks accumulate new turns since last save.

Daily Backup

3:00 AM: Redis → Qdrant Clear Redis 3:30 AM: Files → Backup → Qdrant embeddings

Nightly cron jobs flush buffers to permanent storage.

Infrastructure Topology

Proxmox Cluster

Ollama

10.0.0.10:11434

Embeddings

Qdrant

10.0.0.40:6333

Vector DB

Redis

10.0.0.36:6379

Task Queue

SearXNG

10.0.0.8:8888

Search

Command Reference

User Commands

Command Action Layer
save mem Save all context Redis + File
save q Store to Qdrant Vector DB
q topic Semantic search Vector DB
remember Quick note File

Automation

Schedule Script Action
Heartbeat hb_append.py New turns → Redis
3:00 AM cron_backup.py Redis → Qdrant
3:30 AM sliding_backup.sh File → Backup

Get the Complete Blueprint

Download the full Jarvis Memory blueprint with all scripts, documentation, and installation guide.

Go to Downloads