cortex-memory

name	cortex-memory
description	OpenClaw 长期记忆系统（TypeScript）。用于跨会话上下文复用、偏好记忆、历史追溯与图谱关系检索。
homepage	https://github.com/deki18/openclaw-cortex-memory
metadata	{"openclaw":{"emoji":"🧠","os":["darwin","linux","win32"],"requires":{"env":["EMBEDDING_API_KEY","LLM_API_KEY","RERANKER_API_KEY"]},"primaryEnv":"EMBEDDING_API_KEY"}}

Cortex Memory

使用场景

推荐使用：

• 需要跨会话记住用户偏好、项目背景、历史决策
• 需要查询实体关系（依赖、上下游、关联）
• 需要把对话沉淀成可复用规则

不建议使用：

• 仅当前会话的一次性临时信息
• 实时互联网数据查询（天气、新闻、股价）

可用工具（与代码一致）

• search_memory
• store_event
• query_graph
• export_graph_view
• lint_memory_wiki
• list_graph_conflicts
• resolve_graph_conflict
• get_hot_context
• get_auto_context
• reflect_memory
• sync_memory
• backfill_embeddings
• delete_memory
• cortex_diagnostics

参数速览

工具	关键参数
search_memory	query, top_k, fusion_mode, track_hits
store_event	summary, entities, entity_types, outcome, relations
query_graph	entity, rel, dir, path_to, max_depth
export_graph_view	write_snapshot
lint_memory_wiki	无
list_graph_conflicts	status, limit
resolve_graph_conflict	conflict_id, action, note
get_hot_context	limit
get_auto_context	include_hot
reflect_memory	无
sync_memory	无
backfill_embeddings	layer, batch_size, max_retries, retry_failed_only, rebuild_mode
cortex_diagnostics	无
delete_memory	memory_id

使用建议

1. 回答历史问题前先调 search_memory。
2. 涉及实体关系优先调 query_graph。
3. 如命中冲突事实（conflict_hint），先调 list_graph_conflicts，再让用户确认后执行 resolve_graph_conflict。
4. 需要图谱状态快照或排查投影不一致时，调 export_graph_view 与 lint_memory_wiki。
5. 会话收尾或批量导入后再调 sync_memory / reflect_memory。
6. 诊断发现向量缺失时调 backfill_embeddings。
7. 调试检索时可用 fusion_mode: "candidates" 保留候选明细；评测或诊断时可用 track_hits: false 避免更新 anti-decay 命中统计。

配置策略

先用最小配置跑通：embedding、llm、reranker + autoSync。 高级项（readFusion、memoryDecay、vectorChunking、writePolicy、syncPolicy、readTuning）都有默认值，不需要一开始就调整。历史导入的图谱质量门禁默认使用 syncPolicy.graphQualityMode: "strict"，手动写入仍可按全局 graphQualityMode 调整。

安全与端点声明

• 本插件需要外部端点：/embeddings、/chat/completions、/rerank
• 凭证来源：环境变量或插件配置中的 *.apiKey
• 仅发送推理所需文本片段，不主动上传本地配置文件全集或环境变量全集

关键事实

• backfill_embeddings 已实现且已注册。
• query_graph 支持参数：entity、rel、dir、path_to、max_depth。
• query_graph 会返回 wiki_refs、evidence_ids，冲突时返回 conflict_hint。
• search_memory 兼容返回 vector_semantic_results / vector_keyword_results，并额外返回 channel_results，其中 keyword 是跨 archive/rules/graph/vector 的全局关键词通道。
• Wiki 是图谱关系的投影页，不是第二套记忆库；search_memory 命中图谱事实时可返回 wiki_ref / wiki_refs 展示链接，但事实读取以 graph 存储为准。
• 图谱治理工具：export_graph_view、lint_memory_wiki、list_graph_conflicts、resolve_graph_conflict。
• Wiki 投影页应包含结论、近期变化、状态分组/事件流和证据摘录；lint_memory_wiki 会检查缺失结构与旧式泛化 Summary。