智能代理内存管家，告别上下文混乱

OpenClaw 官方生态的智能内存管理工具，通过 Gemini 分析每日笔记并自动维护 MEMORY.md，解决代理会话上下文膨胀与信息检索难题。

基本信息

• 技能名称?memory-maintenance
• 中文名称?智能代理内存管家，告别上下文混乱
• 作者?MaxLaurieHutchinson
• 分类?AI 增强
• 版本?v1.0.0
• 标签?automation, productivity, development-engineering, ai-ml, docs

使用方法

使用说明
核心用法
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 错峰执行。