Memory Hygiene

核心用法

Memory Hygiene 是一套针对 Clawdbot 向量内存（LanceDB）的运维工具集，主要解决 AI 助手长期使用中记忆膨胀导致的性能与成本问题。

审计功能：通过 memory_recall query="*" 可批量检查当前存储内容，识别冗余数据。清理操作：直接删除 ~/.clawdbot/memory/lancedb/ 目录并重启服务，实现彻底重置。配置优化：关闭 autoCapture 可从源头阻断垃圾记忆写入，同时保留 autoRecall 确保上下文召回能力。数据重建：清理后通过 memory_store 有选择地重新注入关键事实，搭配 category 和 importance 参数实现结构化存储。

显著优点

• 精准定位问题：明确识别心跳状态、临时信息、原始日志等典型垃圾数据源
• 操作粒度灵活：支持全量清理、选择性审计、配置层拦截三种干预层级
• 自动化友好：内置 cron 模板实现月度无人值守维护
• 成本可控：直接减少因无效记忆召回产生的 token 消耗

潜在局限

• 破坏性风险：rm -rf 操作不可逆，误删后依赖 MEMORY.md 重建可能不完整
• 配置门槛：需手动编辑 JSON 并调用 gateway action=config.patch，对非技术用户不够友好
• 依赖外部文件：reseed 流程假定 MEMORY.md 存在且维护良好，若该文件缺失则重建困难
• 无增量清理：缺乏按时间、来源或相似度筛选的精细化删除能力

适合人群

主要面向长期部署 Clawdbot 的开发者、运维人员及高频使用者。特别适合遭遇上下文窗口膨胀、响应延迟增加、API 账单异常的进阶用户。需要具备基础命令行操作能力和配置文件编辑经验。

常规风险

• 数据丢失：清理操作无确认步骤，执行前务必验证 MEMORY.md 备份状态
• 服务中断：重启 gateway 期间助手不可用，生产环境需规划维护窗口
• 配置漂移：手动 patch 配置可能导致与其他插件的冲突，建议变更前 snapshot 当前配置
• 重建偏差：人工 reseed 可能遗漏隐性依赖的记忆片段，影响后续对话连贯性

核心用法

memory-hygiene 是一套面向 Clawdbot 用户的向量内存维护技能，提供完整的 LanceDB 内存管理方案。核心功能包括：

审计与诊断：通过 memory_recall query="*" 快速检视当前内存内容，识别冗余数据。

清理操作：提供两种清理路径——手动执行 rm -rf ~/.clawdbot/memory/lancedb/ 彻底清空，或通过配置禁用 autoCapture 从源头阻止垃圾数据生成。

智能重载：清理后使用 memory_store 重新注入关键事实，支持设置分类标签（preference/fact/decision）与重要性权重（0.7-1.0）。

自动化维护：内置 cron 任务模板，支持每月定时执行"清空-解析-重载-报告"全流程。

显著优点

• 纯文档零风险：无可执行代码，仅提供结构化指南，安全透明
• 痛点精准：直击向量数据库膨胀、无关记忆干扰召回、token成本失控等真实问题
• 最佳实践完备：涵盖存储规范（什么该存/不该存）、配置调优、自动化运维全链路
• 操作可逆：清理后可通过 MEMORY.md 快速重建核心记忆，降低误操作成本

潜在局限

• 非自动化工具：需用户手动执行命令，无一键清理功能
• 版本依赖未明：未说明适用的 Clawdbot/LanceDB 版本范围
• 无备份机制：rm -rf 操作不可逆，文档缺乏预装备份指导
• 许可证缺失：未声明开源协议，影响二次使用确定性

适合人群

• 长期使用 Clawdbot 且记忆库臃肿的高级用户
• 关注 API token 成本优化的开发者
• 需要建立内存维护 SOP 的技术团队

常规风险

• 误执行风险：rm -rf 示例若未谨慎复制可能意外清除数据
• 记忆重建遗漏：清理后若 MEMORY.md 不完整，可能导致关键偏好丢失
• 配置覆盖：禁用 autoCapture 后需手动管理记忆，增加认知负担

安全认证

S级优秀评级，T2可信来源。静态分析95分，无危险函数、无敏感泄露、无第三方依赖。