什么是Session Hygiene
Session Hygiene 是一款专为 OpenClaw 框架设计的自动化会话管理工具，旨在解决因长期运行而导致的 sessions.json 文件无限膨胀问题。在复杂部署环境中，每个钩子（hook）、定时任务（cron）或子代理调用都会生成一条会话记录，这些孤立会话若不及时清理，将迅速累积至数千条甚至上万条，导致配置文件体积暴增（可达200MB以上），进而引发网关响应迟缓、系统无响应等严重性能问题。该技能通过预设的自动化机制，有效维持 sessions.json 文件的轻量化状态，同时完整保留历史会话数据以供追溯。其核心设计理念是在保障系统稳定性的前提下，实现会话生命周期的智能归档与轮换，避免手动维护带来的遗漏风险。无论是小型个人项目还是大规模企业级部署，均可通过简单配置快速启用此功能，显著提升整体运行效率。
核心功能特点
- 自动归档过期会话：将超过48小时的孤立会话批量移动至按日期命名的 JSONL 文件中，保持主 sessions.json 文件精简
- 智能保护关键会话：确保 agent:main:main 核心会话始终不被误删，保障基础功能正常运行
- 自动清理旧归档文件：保留最近30天的归档记录，超出时限的文件将被自动删除以节省存储空间
- 实时运行报告输出：每次执行后详细日志显示归档数量、剩余会话数及各类文件大小信息
- 支持灵活参数调优：可通过命令行调整最大保留时长、归档保留周期等关键阈值以适应不同业务需求
适用场景
Session Hygiene 特别适用于存在高频次自动化操作的生产环境。例如，当一个系统同时集成大量 Webhook 触发器和周期性定时任务时，每轮交互都会产生新的会话条目。若缺乏有效管理机制，仅一周时间就可能积累超过7000条会话，使 sessions.json 突破100MB大关，严重影响系统响应速度。此时，通过设置每6小时执行一次的 Cron 任务即可启动自动归档流程，将陈旧会话转移至独立存档文件，从而显著降低主配置文件负担。此外，对于已出现明显臃肿现象的历史遗留系统，也可手动运行脚本进行一次性深度清理，快速恢复系统性能。该工具同样适合需要长期审计会话历史的场景——归档后的 JSONL 格式便于后续分析处理，既满足合规要求又不干扰当前运行状态。无论您是运维工程师还是开发者，都能借助 Session Hygiene 实现对会话资源的精细化管控。