memory-maintenance

核心用法

Memory Maintenance 是专为 OpenClaw 代理设计的智能内存管理系统，采用"审查-建议-审批-执行"的分级工作流。每日 23:00（可配置），系统自动扫描 memory// 目录下最近 7 天的会话笔记，调用 Gemini 2.5-flash 模型分析内容价值，生成结构化的 MEMORY.md 更新建议（JSON 格式）及人类可读报告（Markdown）。用户通过 --dry-run 预览、、--safe 执行安全维护（仅归档）、--all 确认后执行全部更改。系统同时监控目录健康状态，自动将 7 天以上的审查报告归档至月度桶，30 天后清理，并维护可恢复的 .trash 回收站。

显著优点

智能分层执行：独创三级执行模式（dry-run/safe/all），将风险操作与无害维护分离，既保证自动化效率又守住安全底线。成本优化设计：选用 Gemini 2.5-flash 作为主力模型，在结构化输出任务上实现速度与成本的最佳平衡，甚至提供 lite 版本应对限流。生态深度整合：原生适配 OpenClaw 的 MEMORY.md 标准结构，自动识别 Agent Identity、Infrastructure、Active Projects 等 8 大核心板块，建议精准可落地。防御性架构：强制人工审批内容修改、回收站替代永久删除、硬编码路径虽存但配合环境变量备选，体现安全优先的设计理念。

潜在缺点与局限性

硬编码路径隐患：脚本中硬编码 /Users/maxhutchinson/.openclaw/workspace，跨用户部署时需手动修正或依赖环境变量回退。语法缺陷：apply.sh 的 --all 分支存在模式匹配缺失，可能导致该选项失效。外部依赖链条长：需同时满足 OpenClaw ≥2026.2.0、Gemini CLI、jq 及有效 API Key，任一环节故障即中断服务。隐私权衡：会话内容需上传至 Google Gemini API 分析，对敏感场景存在合规顾虑。上下文窗口限制：7 天回溯期与 10 条建议上限可能遗漏长周期项目的隐性关联。

适合的目标群体

高频使用 OpenClaw 的专业用户：日均多会话、记忆目录快速膨胀的开发者与知识工作者。多项目并行管理者：需要跨会话维护 Active Projects 状态、避免重复上下文设置的产品经理与研究员。注重可审计性的团队：分级审批与完整日志输出满足企业合规要求的中小技术团队。成本敏感型 AI 采用者：愿以轻度人工复核换取显著 API 费用节约的理性用户。

使用风险

数据可用性风险：虽有回收站机制，但误配置 retention 参数或强制 --all 操作可能导致关键历史版本暂时不可访问。API 依赖风险：Gemini 服务中断或密钥失效将直接瘫痪核心审查功能，需建立本地降级预案。命令注入可能：路径变量未充分校验，极端文件名场景下存在 shell 注入攻击面。性能瓶颈：大规模 memory 目录（千级文件）的遍历与 LLM 分析可能触发超时，建议配合 cron 错峰执行。