Persistent memory for AI agents.
Every conversation remembered. Every decision recalled. Every session informed.
Website · Docs · Dashboard · Pricing
______________________________________________________________________
你的AI会在会话之间忘记一切——你是谁,你做了什么决定,什么失败了,什么有效。记忆水晶修复了这个问题。
它实时捕捉对话,提取持久的知识,管理原始的感官记忆,并在每次回应之前注入正确的上下文。一次安装。没有提示体操。你的AI只是 *知道*.
curl -fsSL https://memorycrystal.ai/crystal | bash______________________________________________________________________
适用于所有情况
只需一个命令,即可在任何与MCP兼容的AI工具上安装Memory Crystal:
| 平台 | 安装 | |
|---|---|---|
| 克劳德代码 | `curl -fsSL https://memorycrystal.ai/install-claude-mcp.sh \ | bash` |
| Codex CLI | `curl -fsSL https://memorycrystal.ai/install-codex-mcp.sh \ | bash` |
| Droid工厂 | `curl -fsSL https://memorycrystal.ai/install-droid-mcp.sh \ | bash` |
| 开爪 | `curl -fsSL https://memorycrystal.ai/crystal \ | bash` |
| 克劳德桌面版 | 在设置中添加MCP服务器(引导) | |
| 任何MCP主机 | 指向 https://api.memorycrystal.ai/mcp 带有Bearer代币 |
通用安装程序支持云、本地和自托管后端。它可以注册MCP客户端,配置OpenClaw,安装Codex/Claude挂钩资产,并为离线或自托管工作部署Docker化的本地Converx后端。
______________________________________________________________________
运作原理
You send a message
│
▼
┌─────────────────────────────────────────┐
│ CONTEXT ENGINE │
│ │
│ Semantic search + BM25 across STM/LTM │
│ Knowledge graph boost │
│ Multi-signal reranker │
│ Diversity filter + context budgeting │
│ → Inject top memories into context │
└─────────────────────────────────────────┘
│
▼
AI responds with full context
│
▼
┌─────────────────────────────────────────┐
│ MEMORY EXTRACTION │
│ │
│ Raw message → Short-term memory │
│ LLM extracts facts/decisions → LTM │
│ Graph enrichment links related memories│
└─────────────────────────────────────────┘每一个回应都是基于之前的情况。每一次对话都为下一次对话提供了素材。
______________________________________________________________________
两个存储层
| 图层 | 存储 | 保留 |
|---|---|---|
| 短期(STM) | 最近的原始消息,逐字记录 | 按层滚动窗口 |
| 长期(LTM) | 事实、决定、教训、人、规则 | 永久、矢量索引 |
| 感官原料含量 | 记忆记录背后的原始感官有效载荷 | 汇总、墓碑或受策略保护 |
STM提供了最近的连续性。LTM提供永久知识。感官记忆让Memory Crystal保持持久的回忆价值,而不会永远保留每个原始有效载荷。
五个内存存储
| 存储 | 目的 | 示例 |
|---|---|---|
sensory | 原始信号 | *“用户听起来对部署感到沮丧”* |
episodic | 活动 | *“我们于3月15日发货了v2”* |
semantic | 事实 | *“API将凸用于后端”* |
procedural | 如何 | *“部署 npm run convex:deploy"* |
prospective | 计划 | *“下一个sprint添加计费webhooks”* |
知识图谱
记忆不是孤立存在的。异步后台作业连接相关的记忆——决策链接到通知他们的课程,人们链接到他们的项目,规则链接到创建它们的事件。
当上下文引擎搜索时,图形连接的内存排名更高。你的人工智能不仅能记住事实,还能理解关系。
适应性召回
六种模式,自动选择:
| 模式 | 优先级 |
|---|---|
| 通用 | STM+LTM的广泛召回 |
| 决定 | 风险变更前的决策、教训和规则 |
| 项目 | 目标、工作流程和实施背景 |
| 人们 | 所有权、合作者和关系 |
| 工作流程 | 程序、规则和操作记忆 |
| 对话 | 最近的会议背景和连续性 |
上下文引擎选择正确的模式。你什么都不配置。
______________________________________________________________________
知识库
用于文档、策略、Runbook和导入源材料的一流不可变引用集合。它们与会话记忆放在一起,这样你的代理就可以将学习的上下文和稳定的参考数据分开。
- 不可变的 --导入的块保持稳定,不会被对话重写
- 作用域的 --租户和范围过滤器使KB对正确的工作区保持私有
- 批量导入 --标准导入或大批量插入,嵌入时不会堵塞
- 背景丰富 --嵌入和图形回填异步运行
______________________________________________________________________
24个记忆工具
每个工具都可以在任何MCP主机中工作,也可以在OpenClaw钩子中自动工作。
| 工具 | 它做什么 |
|---|---|
crystal_recall | 跨越所有长期记忆的语义搜索 |
crystal_remember | 储存记忆——决定、事实、教训 |
crystal_what_do_i_know | 关于某个主题的所有已知信息 |
crystal_why_did_we | 决策考古学——为什么做出过去的选择 |
crystal_preflight | 危险行动前的飞行前检查 |
crystal_search_messages | 逐字对话历史记录的混合搜索 |
crystal_checkpoint | 快照里程碑处的内存状态 |
crystal_wake | 会话启动——简报和护栏 |
crystal_trace | 将记忆追溯到其源对话 |
crystal_who_owns | 查找文件、模块或区域的所有权 |
crystal_explain_connection | 解释概念之间的关系 |
crystal_dependency_chain | 跟踪实体之间的依赖链 |
crystal_recent | 短期背景的最新消息 |
crystal_edit | 更新现有内存 |
crystal_forget | 存档或删除内存 |
crystal_stats | 内存和使用统计 |
crystal_set_scope | 覆盖会话的通道范围 |
crystal_list_knowledge_bases | 列出可用的知识库 |
crystal_query_knowledge_base | 搜索知识库 |
crystal_import_knowledge | 将引用块导入KB |
crystal_ideas | 列出活跃的有机想法和发现 |
crystal_idea_action | 对有机理念采取行动 |
memory_search | 搜索LTM并返回晶体路径 |
memory_get | 按ID或路径读取完整内存 |
______________________________________________________________________
HTTP API
所有通过身份验证的HTTP可用的核心操作:
POST /api/mcp/capture Create a memory
POST /api/mcp/recall Hybrid recall over all memory
POST /api/mcp/search-messages Search short-term history
GET /api/knowledge-bases List knowledge bases
POST /api/knowledge-bases Create a knowledge base
POST /api/knowledge-bases/:id/import Import chunks
POST /api/knowledge-bases/:id/bulk-insert High-volume migration
POST /api/knowledge-bases/:id/query Query a knowledge base所有端点都需要 Authorization: Bearer .强制执行按密钥速率限制。
______________________________________________________________________
建筑
memorycrystal/
├── plugin/ OpenClaw plugin — hooks into conversation lifecycle
├── plugins/shared/ Shared hook script for Claude Code, Codex, Factory
├── mcp-server/ MCP server — stdio/HTTP compatibility layer
├── packages/mcp-server/ Streamable HTTP MCP variant
├── convex/ Backend — schema, capture, recall, graph, retention
│ └── crystal/ All Memory Crystal Convex functions
├── apps/
│ ├── web/ Next.js 15 dashboard (Tailwind 4, Convex Auth)
│ └── docs/ Mintlify documentation site
├── scripts/ Install, bootstrap, doctor, enable/disable
└── assets/ Logos and brand assets本地开发
贡献者可以在本地运行一个选择加入的Dockered Converx后端和仪表板,然后在不接触托管生产部署的情况下播种夹具数据:
npm run convex:local:up
npm run convex:local:seed
npm run convex:local:doctor提供者密钥被故意拆分: MEMORY_CRYSTAL_API_KEY 是客户端承载认证, GEMINI_API_KEY 支持Gemini嵌入,可选 OPENROUTER_API_KEY 为有机模型特征提供动力。
本地堆栈使用 http://127.0.0.1:3210 对于凸RPC, http://127.0.0.1:3211 对于HTTP操作,以及 http://127.0.0.1:6791 对于仪表板。看 本地首次设置指南 用于最终用户设置、本地端点、备份和回滚行为以及故障排除。
自托管
在您自己的基础设施上运行所有内容:
git clone https://github.com/memorycrystal/memorycrystal.git
cd memorycrystal && npm install
# Deploy to your own Convex project
CONVEX_DEPLOYMENT=prod:your-project-123 npx convex deploy
# Configure
echo 'CONVEX_URL=https://your-project-123.convex.cloud' > mcp-server/.env
echo 'GEMINI_API_KEY=your-key' >> mcp-server/.env
# Enable and verify
npm run crystal:enable
npm run crystal:doctor对于安装脚本OpenClaw的安装,请直接验证加载的插件:
openclaw plugins info crystal-memory
openclaw crystal_status完整指南: docs.memorycrystal.ai/配置/自我托管
______________________________________________________________________
安全
- 多租户隔离 --所有者检查每次检索,数据库级分离
- API密钥 --SHA-256静态散列,明文从未存储
- 内容扫描仪 --阻止即时注入、编码有效载荷、凭证模式
- 及时缓解注射 --回忆记忆仅作为信息背景注入
- 速率限制 --在所有端点上按密钥执行
- 审核日志记录 --记录到的所有操作
crystalAuditLog - 设备流认证 --CLI密钥配置的RFC 8628样式
- 本地模式 --SQLite回退,数据永远不会离开你的机器
______________________________________________________________________
定价
| 计划 | 价格 | 内存 | STM保留 |
|---|---|---|---|
| 自由 | 每月0美元 | 500 | 7天 |
| 专业版 | 29美元/月 | 25000 | 30天 |
| 表示“超…的”,“极其…的” | 79美元/月 | 无限制 | 90天 |
| 企业 | 自定义 | 自定义 | 自定义 |
自托管始终是免费的。付费计划适用于托管云 memorycrystal.ai.
______________________________________________________________________
贡献
Memory Crystal是麻省理工学院的开源软件。PR欢迎。
git clone https://github.com/memorycrystal/memorycrystal.git
cd memorycrystal && npm install && npm run dev明星历史
______________________________________________________________________
MIT License — memorycrystal.ai — Operated by Illumin8 Inc.
