Skip to main content
Current release: v0.10.1 (OpenClaw plugin, MCP servers, and web app). The Hermes plugin is 0.10.3. Local-backend archives, installer archive defaults, and self-hosted image tags stay on 0.10.0. See the changelog for what shipped, and the uninstall guide when you need to disconnect a client. Memory Crystal keeps context, decisions, and working rules across sessions so you do not restate them every time you start a chat.

​
What you can store

  • architecture and project conventions you already chose
  • commands and workflows the project uses
  • who owns what
  • what failed before
  • reference docs you want an agent to query on purpose
It ships as:
  • an OpenClaw plugin
  • a hosted Streamable HTTP MCP server for compatible clients
  • a stdio MCP server that shares the same tool contracts and adds tools the hosted server does not expose
  • a Convex Cloud backend
  • a web dashboard

​
Hosted endpoints

The hosted backend runs on Convex Cloud. A self-hosted install points both clients at the Convex site you operate: the API base is your site URL, and MCP uses <site>/api/mcp.

​
Capture and recall

  1. Capture records each completed turn once, without a model call on that turn. You can turn automatic capture off independently.
  2. Recall returns a bounded set of eligible memories and recent messages through tools, or through host injection when you explicitly enable it. Injection is off by default, and Grok cannot inject.
On the hosted service and by default when self-hosting, raw messages and raw sensory content stay until you delete them. Durable memories follow a separate lifecycle: distillation, overage-only Forgetting, and an optional stale archive. See How Memory Works, Usage and allowances, and Pricing.

​
MCP servers

Both MCP packages are at 0.10.1 and use the shared tool contract.
  • packages/mcp-server/ is the current Streamable HTTP server used by hosted clients.
  • mcp-server/ is the stdio server. It is still versioned and shipped. It exposes tools that hosted HTTP MCP does not, so the two surfaces are not the same tool list. Use it when a client needs local stdio rather than the hosted HTTP endpoint.

​
Install

/crystal redirects to /install.sh. It is the same installer, not a second one. Next:

​
Client guides