核心用法
Memory Crystal 是一款去中心化AI记忆基础设施，通过 MCP 协议为 Claude Code、Claude Desktop、OpenClaw 等客户端提供统一记忆服务。安装后自动执行：每分钟 cron 捕获对话 → 向量化嵌入（支持 OpenAI/Ollama/Google/MLX）→ 语义检索与持久存储。
关键工作流程：
1. crystal init 一键部署至 ~/.ldm/ 目录，配置数据库、捕获脚本、MCP 服务
2. 选择嵌入 provider（Apple Silicon 推荐免费本地 MLX，其他平台推荐 OpenAI/Ollama）
3. 可选部署 Crystal Core（主节点，负责嵌入与同步）或 Crystal Node（镜像节点，通过加密中继同步）
4. 所有客户端共享 ~/.ldm/memory/crystal.db，支持 crystal_search / crystal_remember / crystal_forget / crystal_status 四工具
显著优点
- 真正的跨会话记忆：突破 Claude 200K 上下文限制，历史对话永久可检索
- 多设备同步：Core-Node 架构 + 端到端加密中继，实现笔记本/台式机/服务器记忆统一
- 语义搜索：基于向量相似度，支持自然语言查询而非关键词匹配
- 数据主权：完全本地存储，无云端依赖，支持自托管中继
- 零配置集成：自动检测 Claude Code/OpenClaw，MCP 工具即装即用
潜在缺点与局限性
- 架构复杂度：Core/Node 角色管理、中继配置对非技术用户门槛较高
- 嵌入成本：OpenAI API 产生持续费用；Ollama/MLX 需本地算力
- 存储膨胀：长期高频使用下数据库体积增长，需定期 compaction（文档未详述策略）
- 同步延迟：Node 依赖中继轮询，非实时同步
- 生态锁定：深度绑定 Claude/Code/OpenClaw 生态，其他 AI 客户端支持有限
适合人群
- 重度 Claude Code 用户，厌烦重复交代项目背景
- 多设备开发者，需要工作流记忆无缝衔接
- 隐私敏感型用户，拒绝云端记忆服务
- 技术型早期采用者，能接受 CLI 配置与故障排查
常规风险
- 数据丢失风险：
crystal.db为本地单点，未配置备份时磁盘故障导致记忆全失 - 密钥泄露：
OPENAI_API_KEY/CRYSTAL_RELAY_TOKEN以环境变量或明文存储 - 权限过度：MCP 服务器获得本地文件系统完整访问权限
- 更新风险：
crystal update虽承诺不碰数据，但自动化脚本潜在 bug 可能导致配置损坏 - 中继信任：WIP.computer 中继虽宣称 E2EE，beta 阶段服务可持续性存疑