#7480: feat: Add CoreMemories hierarchical memory system

by Itslouisbaby open 2026-02-02 21:39 View on GitHub →

docs docker agents

Cluster: Memory Optimization and Gateway Enhancements

## Summary Adds **CoreMemories**: a local‑first, file‑backed memory system with **Flash** (recent), **Warm** (compressed), and **fast keyword retrieval**, plus optional heartbeat maintenance. All integrations are **best‑effort** (non‑blocking) with deterministic storage paths under the agent workspace. ## What’s included (high level) - New package: `packages/core-memories` (`@openclaw/core-memories`) - Best‑effort ingestion from `dispatch-from-config.ts` (user + assistant outputs) - Session‑scoped storage under `<agentWorkspace>/.openclaw/memory/sessions/<sessionKey>/...` - Global keyword links index (JSONL append + compacted JSON index) - Optional heartbeat maintenance (rate‑limited, deterministic clock) - CI/portability fixes (Windows-safe tests) ## Key design goals - **Never block replies/heartbeats** (dynamic imports + try/catch) - **Deterministic paths** (no cwd dependence) - **Isolation** (sessionKey‑scoped storage) - **Bounded growth** (caps, compaction, maintenance) ## Storage layout Per‑session: - `.../memory/sessions/<session>/hot/flash/current.json` - `.../memory/sessions/<session>/hot/warm/week-*.json` - `.../memory/sessions/<session>/index.json` Global links: - `.../memory/links/links.jsonl` - `.../memory/links/index.json` - `.../memory/links/meta.json` ## Testing - `pnpm -C packages/core-memories lint` - `pnpm -C packages/core-memories test` - `pnpm -w check` - `pnpm -w test` ## Status - ✅ All CI checks green - ✅ Greptile reviewed + confirmed fixes - ✅ Merge‑ready