OpenClaw Memory Stack

Total recall. 90% fewer tokens.

Your agent forgets past decisions and burns tokens re-reading the same context. Memory Stack runs 5 search engines locally, returns only what matters, and never loses a fact.

$49 one-time purchase. No subscription, no cloud API costs. All search and storage runs on your machine. One-time license activation requires internet. Buy at openclaw-memory.apptah.com

Architecture

┌──────────────────────────────────────────────────────────────┐
│                  OPENCLAW MEMORY STACK                        │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  SEARCH PIPELINE (runs on every conversation turn)           │
│                                                              │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐               │
│  │  E1  │ │  E2  │ │  E3  │ │  E4  │ │  E5  │               │
│  │ Full │ │Vector│ │ DAG  │ │ Fact │ │  MD  │               │
│  │ Text │ │Search│ │Compr.│ │Store │ │Files │               │
│  └──┬───┘ └──┬───┘ └──┬───┘ └──┬───┘ └──┬───┘               │
│     └────────┴────────┴────────┴────────┘                    │
│                        │                                     │
│                        ▼                                     │
│               ┌──────────────┐                               │
│               │ Result Fusion│                               │
│               │ + Reranking  │                               │
│               └──────────────┘                               │
│                        │                                     │
│              ┌─────────┼─────────┐                           │
│              ▼         ▼         ▼                           │
│          ┌──────┐  ┌──────┐  ┌──────┐                        │
│          │  L0  │  │  L1  │  │  L2  │  Token Budget           │
│          │~100t │  │~800t │  │ full │  Control                │
│          └──────┘  └──────┘  └──────┘                        │
│                                                              │
│  CAPTURE (runs after every conversation turn)                │
│                                                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐        │
│  │    Fact       │  │   Entity     │  │   Dedup &    │        │
│  │  Extraction   │  │  Tracking    │  │  Supersede   │        │
│  │  (8 types)    │  │  (queryable) │  │  (3-level)   │        │
│  └──────────────┘  └──────────────┘  └──────────────┘        │
│                                                              │
│  CROSS-AGENT SHARING                                         │
│                                                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐        │
│  │   CLI API    │  │  Drop Zone   │  │   Unified    │        │
│  │ query/add/   │  │  ~/.openclaw │  │   Global     │        │
│  │   recent     │  │  /external/  │  │   Memory     │        │
│  └──────────────┘  └──────────────┘  └──────────────┘        │
│         ▲                 ▲                 ▲                 │
│  Claude Code       Cursor / Windsurf    Any MCP client       │
│                                                              │
│  SELF-HEALING MAINTENANCE (24h cycle, zero config)           │
│                                                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐        │
│  │  Auto-Init   │  │   Graceful   │  │   Health     │        │
│  │  workspace   │  │   Fallback   │  │   Monitor    │        │
│  │  + indexing   │  │  FTS5-only   │  │  + alerting  │        │
│  └──────────────┘  └──────────────┘  └──────────────┘        │
│                                                              │
└──────────────────────────────────────────────────────────────┘

Built-in Code Search

Find function names, variable names, or any pattern across your entire memory — instantly. No extra tools needed, works offline, gets faster the more you use it.

5-Engine Search

Five engines search in parallel on every conversation turn:

Results are merged with rank fusion, deduplicated, reranked for diversity, and scored with time decay.

3-Tier Token Control

Every wasted token is money burned. Memory Stack eliminates the waste.

Structured Fact Memory

Extracts 8 fact types automatically: decisions, deadlines, requirements, entities, preferences, workflows, relationships, corrections.

• Structured key/value storage with confidence scores
• Negation-aware — "We will NOT use MongoDB" preserved correctly
• Automatic supersede — when a fact changes, old version archived, new one takes over

Smart Dedup & Conflict Resolution

• 3-level write-time dedup: exact match, normalized text, structured key match
• Full audit trail via archive table
• Removes duplicates before sending — you never pay twice for the same memory

Cross-Agent Memory Sharing

Works across Claude Code, Cursor, Windsurf, and any MCP-compatible client.

• CLI commands: openclaw-memory query/add/recent — any tool can read/write facts
• Drop zone: drop .md files into ~/.openclaw/memory/external/ — auto-ingested, no duplicates
• Unified global memory under ~/.openclaw/memory/ — your memory follows you across workspaces

Self-Healing Maintenance

Zero maintenance. The plugin takes care of itself.

• Auto-init: detects workspace, creates search index, schedules embedding — no manual setup
• Graceful fallback: if vector search unavailable, runs in keyword-only mode — always functional
• 24h maintenance cycle: rebuilds index on corruption, archives stale facts, alerts on health issues

OpenClaw Native vs Memory Stack

Install

npx clawhub@latest package install openclaw-memory-stack

Then run ./install.sh --key=oc-starter-xxxxxxxxxxxx to activate with your license key.

Purchase at openclaw-memory.apptah.com.

Runs on macOS, Linux, and Windows (WSL2). Requires bash, python3, and OpenClaw 2026.3.2 or later. Bun is optional (enables QMD vector search).

What the installer does

The included install.sh performs the following actions:

• Files: Copies plugin and backend files to ~/.openclaw/memory-stack/, registers plugin in ~/.openclaw/extensions/openclaw-memory-stack/, updates ~/.openclaw/openclaw.json
• License activation: Sends your license key and a device fingerprint (SHA-256 of machine ID) to openclaw-api.apptah.com/api/activate — one-time, at install
• Periodic verification: Re-verifies license every 7 days (background, non-blocking). Sends only { key, device_id }. 10-day offline grace period
• Upgrade downloads: install.sh --upgrade downloads new versions from openclaw-api.apptah.com with mandatory SHA-256 checksum verification
• No telemetry: No usage data, memory content, or analytics are ever sent. Only license key and device ID leave your machine
• Optional LLM: OPENCLAW_LLM_API_KEY / OPENAI_API_KEY env vars are optional, used only for LLM-powered fact extraction. If not set, falls back to local Ollama/MLX. These keys are sent only to the endpoint you configure (default: api.openai.com), never to our servers

All search and storage runs entirely on your machine.

License

Proprietary. $49 one-time purchase. All features included. No subscription. See full terms at openclaw-memory.apptah.com.

Support

Questions or issues? Contact us at support@apptah.com.