I. 核心架构 - 8. Session Pruning 课程位置阶段I. 核心架构课序第 8 课前置知识I-7. Streaming后续课程I-9. Multi-Agent 本课核心问题如果你问我“Session 文件越来越大磁盘空间不够怎么办之前的对话记录能删掉一些吗”我会这样回答这就是 **Session Pruning会话修剪**要做的事情——它像整理磁盘一样删除不需要的 Session 文件释放空间。 为什么需要 Pruning问题 1磁盘空间耗尽每个 Session 都保存完整的对话对话越多文件越大总有一天磁盘会满问题 2性能下降列出 Session 时需要扫描所有文件文件太多 → 越来越慢问题 3隐私问题旧对话可能包含敏感信息不需要保留太久 Pruning 的策略策略 1按时间删除删除 X 天之前的 Session 例如保留最近 30 天策略 2按大小删除当总大小超过 X MB 时 删除最早的 Session策略 3按活跃度删除超过 X 天不活跃的 Session → 删除⏱️ 什么时候触发 Pruning自动触发1. 定时检查每次 Gateway 启动时 → 检查是否需要 Pruning → 执行删除2. 空间检查当磁盘使用 80% 时 → 自动触发 Pruning → 释放空间手动触发# 手动清理openclaw sessions prune# 查看空间使用df-h~/.openclaw/agents/ 实战配置 Pruning基本配置{ cron: { enabled: true, // Session 保留策略 sessionRetention: 30d, // 保留 30 天false 不自动删除 // 空间管理 maxSessionStorage: 500mb, // 最大存储 500MB // 日志清理 runLog: { maxBytes: 2mb, // 单个日志最大 2MB keepLines: 2000 // 保留行数 } } }更细粒度的配置{ agents: { defaults: { session: { // 保留策略 retention: { maxAgeDays: 30, // 保留 30 天 maxMessages: 1000, // 最多 1000 条消息 maxSize: 10mb // 单个 Session 最大 10MB }, // 何时清理 prune: { onStartup: true, // 启动时清理 threshold: 80% // 超过 80% 时清理 } } } } } Pruning 的效果效果示例Pruning 前Session 文件数1,000 个总大小2 GB列出 Session需要 5 秒Pruning 后Session 文件数100 个总大小200 MB列出 Session需要 0.5 秒效果节省 90% 空间⚠️ 常见陷阱陷阱表现原因解决删除太多需要的 Session 没了保留时间太短调整保留时间没删除空间仍然不够Pruning 没启用检查配置误删重要重要对话被删没有排除规则设置排除列表 学习心得我学这一课时的体会我以前以为 Session 文件会一直保存没想过要清理。学完后才知道Pruning 是必要的维护工作要在保留历史和节省空间之间平衡设置合适的保留策略很重要这让我想到Compaction 是优化单个 SessionPruning 是清理整个 Session 集合。与其他课程的关联前置课程Session 管理 - Session 是什么前置课程Compaction - 压缩单个 Session后续课程Multi-Agent - 多 Agent 的 Session✅ 你现在应该理解的解释为什么需要 Pruning说出三种 Pruning 策略知道什么时候触发 Pruning能配置 Pruning 参数 快速参考表概念简单说Session Pruning清理不需要的 Session按时间删除删除 X 天前的按大小删除删除最大的按活跃度删除删除不活跃的 相关资源官方文档Sessionhttps://docs.openclaw.ai/concepts/sessionCronhttps://docs.openclaw.ai/automation/cron-jobs相关课程上一课I-7. Streaming下一课I-9. Multi-Agent 本课总结最关键的 3 点为什么需要节省磁盘空间提升性能保护隐私三种策略按时间、按大小、按活跃度可以组合使用配置建议启用 Pruning设置合理的保留时间定期检查现在你应该理解了如何管理 Session 文件。下一课会讲如何管理多个 AgentMulti-Agent。