Requires OpenClaw installed. Bash installs the native plugin; PowerShell provides the generic MCP path.
Verify: openclaw plugins info crystal-memory; openclaw crystal_status.
Caveat: PowerShell writes generic MCP guidance for OpenClaw. Use Bash, WSL, or Git Bash for the native OpenClaw plugin install.
Agent Prompt — works with every agent
Paste this one prompt into any AI agent. It installs Memory Crystal for the apps on the machine, verifies the tools load, and briefs the agent to use its memory to the fullest in every session. The installer also ships the crystal skill suite (brief, kb, architect, hygiene, checkpoint) to hosts that support skills — opt out with --no-skills.
Set up Memory Crystal (persistent memory) on this machine, then use it in every session from now on.
STEP 1 - INSTALL
Run the official installer in a terminal (it auto-detects the AI apps on this machine and asks per app):
macOS / Linux / WSL: curl -fsSL https://memorycrystal.ai/crystal | bash
Windows PowerShell: iwr https://memorycrystal.ai/install.ps1 -OutFile install.ps1; .\install.ps1
Follow the prompts for sign-in and backend mode. To configure specific apps only, pass --targets with any of: claude-code, claude-desktop, codex-cli, codex-desktop, opencode, factory-droid, hermes, openclaw, generic-mcp. Do NOT hand-edit agent config files unless the installer explicitly asks. Docs: https://docs.memorycrystal.ai/installation
STEP 2 - VERIFY
Restart this app (or start a new session), confirm the memory-crystal MCP server is loaded, and call crystal_status or crystal_stats to prove the tools respond. If they are missing, re-run the installer and read its output before changing anything by hand.
STEP 3 - USE MEMORY CRYSTAL. MANDATORY, EVERY SESSION, NOT OPTIONAL.
- BEFORE answering anything involving past work, decisions, people, projects, or preferences: call crystal_recall first (crystal_what_do_i_know for broad topics). Never answer from vague recollection.
- Need exact past wording, quotes, commands, or code? crystal_search_messages.
- AFTER learning any durable fact, decision, preference, lesson, or goal: save it with crystal_remember immediately, without being asked. Correct existing memories with crystal_update; replace outdated ones with crystal_supersede.
- BEFORE config changes, deletions, or external sends: crystal_preflight for the rules and lessons that apply.
- Reference material lives in knowledge bases: crystal_list_knowledge_bases to discover them, crystal_query_knowledge_base with the KB name for targeted lookups.
- Before changing something you did not build: crystal_why_did_we / crystal_who_owns / crystal_explain_connection.
- At major milestones, or when the user asks for a backup: crystal_checkpoint.
Only skip these tools for greetings, small talk, or questions fully answered inside the current conversation.
Terminal — bash
[ WHY MEMORY CRYSTAL ]
Stop re-explaining. Start shipping.
Memory Crystal gives your AI agents durable memory across compactions, restarts, and new sessions. Decisions, workflows, and context stay available exactly when your agent needs them.
Works withOpenClawClaude CodeCodex CLICursorAny MCP Client
Two layers. One memory system that stays with your agents.
Memory Crystal handles both the live context your agent needs right now and the persistent memory it should keep forever. It works passively in the background, so context survives compaction, restarts, and switching between tools.
Layer 1
In-session context
Fast, live memory for the conversation happening right now.
Captures every turn as you work
Semantically enriches messages, entities, and decisions
Uses the recall hook to inject the right context before each response
Durable knowledge that keeps accumulating across sessions, tools, and machines.
Syncs memory to Convex in the cloud
Survives compaction, restarts, and brand-new sessions
Available across tools and machines through MCP
Supports scoped knowledge bases for private reference data
Storage
Cloud-synced memory backed by Convex and exposed everywhere through MCP.
Why it feels different
Semantic search + knowledge graph, not just text search
Immutable knowledge bases for docs, policies, and imported reference material
Cross-platform memory for OpenClaw, Claude Code, Codex, Factory, and any MCP client
Automatic capture and recall — text, images, audio, video, and PDFs
Scoped memory and KB isolation for private client, tenant, and agent lanes
[ MEMORY IN ACTION ]
See what happens when your agent actually remembers.
Real examples across Terminal, Discord, Telegram, Claude Code, and Codex — your agent recalls context no matter where the conversation happens.
Agent recovers full project context after session compaction — no re-explaining needed.
[ HOW IT WORKS ]
From conversation to persistent knowledge in six steps.
Memory Crystal captures, embeds, enriches, and stores your agent's context — then recalls it automatically when needed.
1. Capture
Your agent has a conversation
2. Embed
Memories are semantically embedded
3. Enrich
Knowledge graph extracts relationships
4. Store
Durable cloud storage
5. Recall
Agent queries memory before responding
6. Respond
Agent answers with full context
1. Capture
Your agent has a conversation
Every message, decision, and piece of context flows through the capture hook. Memory Crystal watches for important information — architecture decisions, preferences, project context, action items.
Step 1 of 6
[ EARLY USERS ]
What builders are saying.
“We integrated Memory Crystal into our AI platform and it changed everything. Before, the AI started every session essentially cold. Now it wakes up knowing each user's active goals, what progress they've made, what patterns keep showing up. Each of our 30+ users gets their own isolated memory store — completely private. The difference isn't incremental. An AI that remembers is a completely different product than one that forgets.”
“I've been building AI agent workflows for my business for a year and the biggest friction was always context loss. Every Monday I'd spend 20 minutes re-orienting my agent on active projects, decisions we'd made, things to avoid. Memory Crystal eliminated that entirely. Now I open a session and it just knows where we are. It's the piece that was missing.”
“What convinced me was the privacy model. Each channel gets its own isolated memory — nothing bleeds between clients, nothing bleeds between contexts. For the kind of sensitive conversations I facilitate, that separation isn't optional. Memory Crystal was the only tool that had it built in from the start, not bolted on. Grateful this exists.”
Self-Hosted or Cloud
Get Started — Free
Run Memory Crystal on your own hardware or let us host it. Pick a slug, get your docker compose command, and go.