| name | mema |
| description | Mema's personal brain - SQLite metadata index for documents and Redis short-term context buffer. Use for organizing workspace knowledge paths and managing ephemeral session state. |
Mema Brain (Centralized Memory)
Standardized memory system providing a Metadata Index (SQLite) and Short-Term Context (Redis).
Core Components
1. Document Index (SQLite)
- Primary Path:
~/.openclaw/memory/main.sqlite
- Capability: Stores file paths, titles, and tags.
- Note: This is a Metadata Index only. It does not ingest or provide full-text search of file contents.
2. Short-Term Memory (Redis)
- Key Prefix:
mema:mental:*
- Purpose: Ephemeral state management and cross-session context passing.
- TTL: Default 6 hours (21600 seconds).
Core Workflows
Indexing Knowledge
Record a file's location and tags in the local database.
- Usage:
python3 $WORKSPACE/skills/mema/scripts/mema.py index <path> [--tag <tag>]
Searching Index
List indexed paths filtered by tag or recency.
- Usage:
python3 $WORKSPACE/skills/mema/scripts/mema.py list [--tag <tag>]
Mental State (Redis)
Manage key-value pairs in the mema:mental namespace.
- Set:
python3 $WORKSPACE/skills/mema/scripts/mema.py mental set <key> <value> [--ttl N]
- Get:
python3 $WORKSPACE/skills/mema/scripts/mema.py mental get <key>
Setup
- Copy
env.example.txt to .env.
- Configure
REDIS_HOST and REDIS_PORT (defaults: localhost:6379).
- Initialize the SQLite schema:
python3 $WORKSPACE/skills/mema/scripts/mema.py init
Reliability & Security
- Data Privacy: All data is stored locally.
- Network Safety: Only point
REDIS_HOST to trusted instances.
- Path Isolation: Database operations are confined to the
~/.openclaw/memory directory.
