name: openclaw-session-guard description: 管理 OpenClaw 长会话防爆机制（80%自动归档、自动轮换新会话、低 token 交接）及定时任务安装。用户提到 compacting context、会话过长、自动总结归档、session 轮换、LaunchAgent 定时任务时使用。

OpenClaw Session Guard

用于治理 OpenClaw 会话上下文过长导致的反复 compaction。

适用场景

• 用户反馈 compacting context 频繁出现
• 想要“到阈值自动摘要+存档+续聊”
• 需要安装/检查/卸载会话轮换定时任务

默认策略

• 阈值：80%
• 冷却：1800s（30 分钟）
• 扫描周期：300s（5 分钟）
• 摘要条数：每个角色最近 6 条

快速操作

1. 安装/更新

bash ~/.openclaw/skills/openclaw-session-guard/scripts/install.sh

2. 查看状态

bash ~/.openclaw/skills/openclaw-session-guard/scripts/status.sh

3. 卸载

bash ~/.openclaw/skills/openclaw-session-guard/scripts/uninstall.sh

交付要求

• 给用户汇报：当前阈值、冷却、扫描周期
• 给用户汇报：最新归档文件与最新轮换 sessionId
• 若失败：给出可执行修复命令，不只描述原因

参考

• 详细机制和目录说明见 reference.md