核心功能
Cortex Memory 是一款基于知识图谱的长期记忆系统，超越传统向量搜索的局限，通过提取事实、实体和关系构建结构化记忆网络。核心能力包括：
- 混合检索：BM25 + 语义搜索 + 时序通道 + 图遍历，支持
full深度模式与fast快速模式 - 实体关系追踪：自动识别人物、项目、概念间的关联，回答"X 与 Y 如何关联"类复杂问题
- 时序推理：追踪事实演变（如信念漂移、信息过时），识别 SUPERSEDES 关系
- 多会话持久化：跨天、跨项目保留关键信息，支持按 session ID 分域检索
显著优势
1. 召回质量显著优于 memory_search：特别适用于跨会话事实查询、实体关系探索、时序变化追踪等场景
2. 结构化存储：自动提取实体别名、事实核心陈述，减少语义漂移
3. 灵活的检索模式：fast 模式 80-150ms 适合快速检查，full 模式 300-600ms 提供完整图遍历
4. 会话分域管理：支持 openclaw:project-name:topic 等命名规范，实现项目级隔离
局限性与注意事项
- 延迟成本：
full模式比原生内存慢一个数量级，不适用于简单当日查询 - API 依赖：需外部 Cortex 服务，网络故障时需降级至
memory_search - 配置复杂度：需管理
CORTEX_API_KEY与CORTEX_BASE_URL，且 API 密钥需安全保管 - 非实时同步：需显式调用 ingest，不会自动捕获所有对话
适用场景
| 场景 | 推荐方案 |
|------|---------|
| 当日上下文、关键词匹配 | 原生 `memory_search` |
| 跨周/月的事实 recall | Cortex `fast` 模式 |
| 实体关系查询（"Sarah 负责哪些项目"） | Cortex `full` 模式 |
| 时序变化追踪（"需求何时变更"） | Cortex `full` 模式 |
| 项目级信息隔离查询 | Cortex 带 session 过滤 |
常规风险
- API 密钥泄露：
CORTEX_API_KEY需严格保密，禁止在输出、日志中暴露 - 敏感数据上传：避免将密码、令牌等凭证发送至 Cortex 服务
- 服务可用性：Cortex 为外部 SaaS，存在网络中断、服务降级风险，必须实现降级逻辑
- 数据隔离：虽采用租户级隔离，但敏感商业信息仍建议本地脱敏处理