核心用法
Context Manager 是专为 Clawdbot/Moltbot 设计的 AI 驱动上下文管理技能,解决长会话中上下文窗口耗尽、响应变慢的问题。核心机制是让 AI 自我总结会话内容,生成压缩摘要后重置会话并注入摘要,实现 70%+ 的 token 缩减。
主要命令
list/status [KEY]- 查看会话列表和详细状态summarize [KEY]- 生成 AI 摘要(只读,安全)summarize [KEY] --replace- 完整压缩流程:摘要 → 备份 → 重置 → 注入set-threshold/set-depth- 配置压缩阈值和摘要深度
工作流程
1. AI 自总结:向 agent 发送特殊 prompt,要求其总结「已完成任务、关键决策、当前状态、待办事项、关键上下文」
2. 安全备份:原始 JSONL 会话文件保存至 memory/compressed/
3. 官方重置:删除 JSONL 文件(Moltbot 官方推荐的 reset 方法)
4. 上下文注入:将 AI 摘要作为新会话的第一条消息
5. 结果:相同 session key,新 session ID,大幅压缩的上下文
显著优点
- 效率高:70k tokens → 16k tokens(77% 缩减)的实测效果
- 智能性强:AI 自我总结比基于规则的提取(grep/正则)质量更高,能保留决策 rationale 和隐含上下文
- 操作安全:支持「预览模式」(summarize 不带 --replace),压缩前可先验证摘要质量
- 自动备份:每次压缩自动保存原始会话,支持完整恢复
- 非侵入式:无需修改 agent 或 gateway 代码,纯 shell 脚本实现
潜在局限
- 单点依赖:依赖 clawdbot/moltbot gateway 运行状态,gateway 不可用时无法操作
- 外部工具依赖:需要预装
jq进行 JSON 解析 - 破坏性操作风险:
--replace模式会永久删除原始 JSONL(虽有备份),误操作可能导致上下文丢失 - 摘要质量不可控:AI 生成的摘要质量取决于原会话的清晰度,复杂多线程会话可能遗漏关键细节
- 仅适用于特定生态:专为 Clawdbot/Moltbot 设计,无法直接用于其他 AI 平台
适合人群
- 高频使用 Clawdbot/Moltbot 的专业用户:需要长时间维护同一会话进行复杂任务(代码开发、研究分析、内容创作)
- 多会话管理者:同时运行多个会话(main + Slack channels + cron jobs)需要监控和优化资源
- 追求响应速度的用户:上下文接近上限时模型响应变慢,需要 proactively 维护
常规风险
- 误操作导致数据丢失:
--replace模式不可逆,虽然有备份但恢复需要手动操作 - Node 警告污染输出:脚本使用
2>/dev/null屏蔽 Node deprecation warnings,可能掩盖真正的错误信息 - 时区/静默时间配置:
set-quiet-hours等高级功能需确保系统时区配置正确 - 备份目录膨胀:频繁压缩会产生大量备份文件,需要定期清理
memory/compressed/ - AI 幻觉风险:极端情况下 AI 可能生成不准确的摘要,导致新会话基于错误上下文继续