核心用法
Cortex Memory 是专为 OpenClaw 智能体设计的一套长期记忆管理系统，核心解决 AI 助手"健忘"的行业痛点。该技能通过三重机制运作：
1. 自动召回（Auto-Recall）：每次对话轮次开始前，系统会自动检索与用户当前话题相关的历史记忆，以 <cortex_memories> 代码块形式注入上下文。但开发者明确提醒：这仅是"起点"而非全貌。
2. 主动搜索（Search）：面对具体事实查询，智能体需调用 cortex_search_memory 工具，支持多模式检索（facts/decisions/preferences/recent）和多跳推理查询。规则强制要求：在表示"不知道"之前，必须使用至少 2 种不同查询策略。
3. 智能保存（Save）：分为自动捕获（auto-capture，生成话题摘要）和显式保存（explicit save，针对技术实现细节）。后者尤为关键——当响应包含具体技术细节（如缓存键模式 arclight:user:{userId}、SQL 语句、架构决策理由）时，必须在回合结束前主动调用 cortex_save_memory。
此外，技能提供完整的记忆生命周期管理：按实体或会话删除（cortex_forget）、精确检索（cortex_get_memory）、会话目标设定（cortex_set_session_goal）以及 CLI 状态监控（openclaw cortex status/memories/search 等）。
显著优点
第一，真正的跨会话智能。不同于传统 RAG 的临时上下文窗口，Cortex 实现了事实、偏好、决策的持久化存储，使 AI 助手能建立长期用户画像和工作知识库。
第二，开发者友好的强制约束。SKILL.md 中大量"必须"（MUST）级别的行为规则，如"搜索前不得推诿""技术细节必须显式保存"，有效对抗 LLM 的幻觉倾向和懒惰应对，提升可靠性。
第三，隐私与合规设计成熟。明确的数据处理说明（对话事实提取、敏感信息过滤、易变状态剥离）、完整的用户控制选项（禁用自动捕获/召回、审计模式、遗忘工具），并通过 GDPR/CCPA 合规认证。
第四，与 TooToo Bridge 的有机整合。当检测到用户处于反思性对话状态时，智能体可提出单一、简洁的发现性问题（如"工作中你最看重什么？"），将记忆能力与个人成长辅助结合。
第五，零依赖轻量架构。纯 Markdown 文档型技能，无可执行代码，安全审计通过率高。
潜在缺点与局限性
记忆质量依赖保存策略。自动捕获仅生成话题级摘要，技术细节若未显式保存将永久丢失。这对开发者的"保存意识"提出较高要求，存在"以为记住了实则没记住"的认知鸿沟。
外部服务依赖与数据主权。核心功能依赖 Kwanda 托管的 Cortex API（api.cortex.kwanda.io），数据需出境处理。虽有 TLS 加密和密钥隔离，但对数据本地化要求严格的场景构成障碍。
记忆陈旧与冲突风险。文档明确警告："不要将重复召回等同于真相"——错误记忆可能被反复强化。当记忆与实时工作空间状态冲突时（如端口、版本号），需人工判断以何者为准。
搜索策略的学习成本。多模式检索、多跳查询、不同 mode 参数的组合使用，需要一定实践才能掌握最优策略，初期可能面临"搜不到"的挫败感。
配置复杂度。虽然支持最小权限配置，但 README 同时推荐 tools.profile: full，存在过度授权诱惑。CLI 工具链的完整功能也需要终端访问权限。
适合的目标群体
- 长期项目协作者：需要 AI 助手持续跟踪多周/多月的复杂项目背景、技术决策演变
- 个人知识管理者：希望 AI 建立个人偏好档案、阅读历史、决策模式的深度用户
- 开发团队技术负责人：需要维护架构决策记录（ADR）、调试历史、性能优化脉络
- 高上下文工作流用户：客服、咨询、创意等行业，客户信息和工作方法论的跨会话继承至关重要
不适合：单次问答需求者、对数据出境敏感的组织、无 API 密钥配置能力的用户。
常规使用风险
性能层面：Cortex API 不可达时，自动召回静默降级，自动捕获后台重试，但显式工具调用会报错。需设计优雅降级策略，避免用户操作阻塞。
依赖项风险：核心功能绑定 openclaw-cortex 插件，若该插件版本不兼容或 API 变更，技能将失效。建议锁定插件版本并监控 Kwanda 平台公告。
数据积累风险：长期记忆若无定期审计，可能充斥过时信息，反而污染召回质量。建议结合 /audit on 和 cortex_forget 建立月度清理机制。
密钥泄露风险：API 密钥若硬编码或不当共享，可能导致记忆数据暴露。务必使用环境变量存储，并制定泄露后的紧急轮换预案。
反馈循环风险：禁止保存工具输出或刚召回的记忆——但开发者若误操作，可能形成"用记忆证明记忆"的自指循环，放大错误。