OpenClaw Memory Core

Shared library powering OpenClaw's memory plugins (openclaw-memory-brain and openclaw-memory-docs). Provides three core modules:

Redaction

Automatically detects and redacts secrets before they reach memory storage. Covers: - API keys (OpenAI, Anthropic, Stripe, Google, GitHub PATs) - AWS credentials (access keys, secret keys) - Azure storage keys, HashiCorp Vault tokens - JWTs, Bearer tokens, PEM private key blocks

Usage: pipe any text through the redactor before storing — secrets are replaced with safe [REDACTED:TYPE] placeholders.

JSONL Store

Local file-based memory store using append-only .jsonl files. Features: - CRUD for memory items (kinds: fact, decision, doc, note) - Expiration support (expiresAt field) - Semantic search via cosine similarity on embeddings - No external database required — everything lives in flat files

Embeddings

Deterministic, offline, dependency-free text embedder (HashEmbedder): - FNV-1a hash-based vector generation (default 256 dimensions) - L2 normalization for cosine similarity search - No API calls, no model downloads — works fully offline - Not SOTA semantics, but stable and fast for local vector search

Integration

This is a dependency library, not a standalone plugin. Install it as a package dependency:

npm install @elvatis_com/openclaw-memory-core

Used internally by openclaw-memory-brain (auto-capture) and openclaw-memory-docs (explicit capture).