Smart Context Manager

核心功能

Context Manager是专为OpenClaw设计的上下文压缩技能，解决长会话导致的性能下降和token耗尽问题。它利用AI自身能力生成智能摘要，然后重置会话并注入压缩后的上下文，实现"换血不换魂"的会话延续。

核心用法

| 场景 | 命令 |

|------|------|

| 查看所有会话 | `compress.sh list` |

| 安全预览摘要 | `compress.sh summarize [KEY]` |

| 一键压缩重置 | `compress.sh summarize [KEY] --replace` |

| 调整触发阈值 | `set-threshold N` (50-99%) |

显著优点

1. AI自摘要：利用agent对自身上下文的完全可见性，生成比传统提取更精准的语义摘要
2. 非破坏性设计：--replace前可先preview，自动备份原始JSONL到memory/compressed/
3. 量化效果：实测70k tokens → 16k tokens（77%压缩率），显著恢复响应速度
4. 智能调度：支持安静时段设置，避免高峰压缩

局限性与风险

| 类型 | 说明 |

|------|------|

| 数据丢失 | 压缩会丢失对话细节、语气上下文、多轮推理痕迹，仅保留结构化摘要 |

| 恢复依赖 | 虽有备份，但手动恢复JSONL需要技术操作 |

| 模型依赖 | 摘要质量受限于当前agent模型的理解能力 |

| 不可逆性** | `--replace`操作无法撤销，摘要错误将导致上下文永久变形 |

适合人群

• 高频长会话用户：每日对话超50轮、上下文持续数小时的OpenClaw重度用户
• 多任务切换场景：同一session跨越多个项目/主题，需要定期"归档"整理
• 性能敏感场景：在旧设备或高延迟环境下追求响应速度

常规风险提示

• 务必先preview：首次使用或重要会话，先用summarize（无--replace）验证摘要质量
• 避开关键节点：不要在代码调试中途、复杂推理未完成时压缩
• 保留备份窗口：压缩后24小时内建议保留memory/compressed/备份，确认无误再清理
• Slack/cron优先测试：建议在非核心会话上验证压缩效果，再用于main主会话

核心用法

Context Manager 是专为 OpenClaw 设计的会话上下文管理 Skill，通过 AI 生成智能摘要并压缩会话历史，解决长对话导致的 token 耗尽和性能下降问题。

主要功能：

• 状态监控：list/status 实时查看所有会话的 token 使用量（默认阈值 80% 触发提醒）
• 安全预览：summarize 命令生成 AI 摘要，仅读取不修改，可验证摘要质量
• 一键压缩：summarize --replace 执行完整压缩流程：AI 摘要 → 备份原会话 → 删除 JSONL 重置 → 注入摘要到新会话
• 配置管理：支持调整压缩阈值（50-99%）、摘要深度（brief/balanced/comprehensive）、静音时段

显著优点

• 智能自洽：利用 AI 自身总结上下文，比规则提取更准确
• 零数据丢失：自动备份至 memory/compressed/，支持完整恢复
• 透明可控：预览模式避免误操作，所有步骤 CLI 可见
• 效率提升：实测 70k tokens → 16k tokens（77% 压缩率），显著恢复会话性能
• 依赖极简：仅依赖 jq 和 OpenClaw 官方 CLI，无第三方 npm 包

潜在缺点与局限

• OpenClaw 生态锁定：专为 OpenClaw 设计，无法跨平台使用
• 会话中断：--replace 会重置会话 ID，需重新建立对话上下文（虽内容已注入）
• 摘要质量依赖模型：复杂多线程对话的摘要可能遗漏关键细节
• 无交互确认：--replace 直接执行删除，虽有备份但仍建议先预览
• bash 脚本限制：复杂错误场景（如注入失败后的状态同步）处理不够健壮

适合人群

• 重度 OpenClaw 用户，单会话持续数小时以上的开发者/研究者
• 需要维护长期项目上下文的团队协作场景
• 对 token 成本敏感，希望延长会话生命周期的用户

常规风险

• 误操作风险：--replace 直接删除会话文件，虽有自动备份，但恢复需手动操作
• 摘要信息损失：任何压缩都会丢失原始对话细节，关键决策建议额外存档
• 模型幻觉：AI 生成的摘要可能存在偏差，重要信息建议 summarize 预览确认
• 依赖可用性：依赖 OpenClaw CLI 稳定性，若网关故障则功能不可用

安全认证得分 78/A 级，无恶意代码，数据操作本地完成，符合 GDPR 数据最小化原则。