OpenClaw 官方生态的智能内存管理工具，通过 Gemini 分析每日笔记并自动维护 MEMORY.md，解决代理会话上下文膨胀与信息检索难题。
说明：
## 核心用法
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 错峰执行。
会员专属
