核心用法
OpenCortex 是一套面向 OpenClaw 智能体的记忆增强框架，通过脚本化安装将默认的智能体升级为具备结构化记忆、夜间自动蒸馏、周度综合复盘能力的持续学习系统。安装后会在工作空间生成标准化文件层级（SOUL.md/AGENTS.md/MEMORY.md 等 6 个核心文件 + memory/ 目录），并注册每日 3 AM 的蒸馏任务与每周日 5 AM 的综合任务。
使用场景明确限定为四类：（1）全新 OpenClaw 实例初始化；（2）用户要求改善/整理记忆；（3）用户抱怨智能体"健忘"；（4）需要按最佳实践引导新智能体。明确不用于运行时的 memory_search 查询（应使用内置工具）。
显著优点
1. 知识复利机制：通过"每日工作 → 日志 → 夜间蒸馏 → 项目/工具/基础设施文件"的管道，配合周度模式识别与自动 Runbook 生成，实现经验的持续积累而非会话级遗忘。
2. 原则驱动的质量保障：内置 P1-P8 八项原则（如"优先委派""写入而非记忆""失败日志"等），并由夜间审计强制执行，确保工具文档、决策捕获、子代理汇报等不被遗漏。
3. 隐私优先的安全设计：敏感功能（声纹分析、基础设施自动收集、Git 推送）默认关闭，需通过环境变量显式启用；安装过程零网络调用；加密仓库采用 AES-256，密钥轮换支持；Git 备份在隔离临时副本中清理敏感信息，原始工作区文件永不修改。
4. 可审计与可逆：Bash 脚本完全可审计，支持 --dry-run 预览；安装器可安全重入，更新路径非破坏性。
5. 模型无关性：支持通过 .opencortex-model 配置任意 AI 模型（Sonnet/Opus/Haiku 等）执行定时任务。
潜在缺点与局限性
- 环境依赖：需 OpenClaw 2026.2.x+ 及 ClawHub CLI 作为前置条件，对非标准环境可能需手动适配。
- 学习曲线：八项原则与文件层级需用户初期投入理解成本，MEMORY.md 需手动维护索引以保持 <3KB 的会话加载效率。
- Cron 环境限制：定时任务依赖主机 Cron 服务，容器或无 Cron 环境需额外配置。
- Git 备份的隐式风险：虽采用隔离副本清理，但
.secrets-map配置错误仍可能导致敏感信息泄露；OPENCORTEX_SCRUB_ALL启用后对非文本文件的粗暴清理可能引发意外。 - 声纹与基础设施收集的伦理边界：虽为 opt-in，但一旦启用即进入持续收集模式，用户需自行评估合规性。
适合人群
- 长期运行同一 OpenClaw 实例、希望跨会话保持上下文的专业用户
- 团队协作场景下需要可审计、可继承的 Agent 记忆架构
- 对数据主权敏感、要求本地优先（local-first）隐私控制的极客用户
常规风险
- Cron 锁竞争：每日与每周任务通过
/tmp/opencortex-distill.lock互斥，异常终止可能导致锁残留需手动清理。 - Vault 密钥管理：
OPENCORTEX_VAULT_PASS环境变量虽便利但安全性低于系统密钥环；文件式密钥存储（OPENCORTEX_ALLOW_FILE_PASSPHRASE）为降级方案。 - 模型 API 成本：夜间蒸馏与周度综合持续调用 LLM，高活跃工作空间可能产生非显著但持续的 Token 消耗。
- 升级兼容性：--force 重装后需重新运行安装脚本以应用更新，遗忘此步骤可能导致新旧组件版本漂移。