name: openclaw-memory-core description: Core utilities for OpenClaw memory plugins (redaction, local store, embeddings).

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).