Smart Context Manager

核心用法

Context Manager 是 OpenClaw 生态系统的会话生命周期管理工具，解决 AI 长上下文窗口的性能衰减问题。核心工作流为四步闭环：

1. AI 自总结：向当前会话 agent 发送结构化 prompt，让其基于完整上下文生成涵盖「已完成任务」「关键决策」「当前状态」「待办事项」「关键记忆」五维度的摘要
2. 安全备份：将原始 JSONL 会话文件完整归档至 memory/compressed/
3. 硬重置：删除 JSONL 文件触发 OpenClaw 官方重置机制（非 /reset 指令，避免被误解析为普通消息）
4. 上下文注入：通过 openclaw agent --to main 将 AI 摘要作为新会话首条消息注入，保持相同 session key 但生成新 session ID

显著优点

• 自指优化：利用 agent 对自身上下文的完全可见性，生成质量远高于外部启发式提取（对比内置 compress 命令的 grep 方案）
• 可控破坏性：summarize 与 --replace 分离设计，允许先审阅摘要质量再执行重置
• 零配置集成：自动发现 OpenClaw 网关、依赖仅 jq，无需额外模型或 API key
• 可恢复性：每次操作生成带时间戳的完整备份，支持手动回滚

潜在局限

• 生态锁定：仅支持 OpenClaw 网关协议，无法迁移至原生 Claude/ChatGPT 会话
• 摘要质量依赖模型能力：若底层模型（如 gemini-3-flash）总结能力不足，可能丢失 subtle context
• 重置即断联：硬重置导致与外部系统的 session 关联（如 Slack thread）断裂，需人工重新建立
• 无自动化触发：阈值检测需手动 check 或 check-all，缺乏基于使用率的自动压缩

适合人群

• 运行 4h+ 长会话的 OpenClaw 高级用户
• 需要保持对话连续性但受限于 100k token 窗口的开发者
• 构建自动化工作流、需定期上下文整理的 cron/session 管理者

常规风险

• 数据丢失：--replace 操作不可逆，尽管有备份，恢复需手动 JSONL 替换
• 总结偏差：AI 可能错误理解自身上下文优先级，导致关键信息被压缩丢弃
• 时序混乱：注入摘要后，历史消息时间戳丢失，依赖时间线的工具可能失效

核心用法

context-manager 是一款专为 OpenClaw 设计的 AI 会话管理工具，核心解决长对话导致的 token 耗尽和响应迟缓问题。通过 compress.sh 脚本提供完整的生命周期管理：

• 监控: list 查看所有会话状态，status [KEY] 检查特定会话 token 使用率
• 诊断: summarize [KEY] 安全生成 AI 摘要（只读，不影响会话）
• 压缩: summarize [KEY] --replace 执行完整压缩流程——生成摘要、备份原始会话、重置并注入压缩上下文

技术实现独特：让 AI 自我总结上下文（"agent has full visibility into its own context"），而非简单的文本截断，保留关键决策、待办任务和重要上下文。压缩效果显著，示例中 70k tokens 降至 16k（77% 缩减）。

显著优点

1. 智能化压缩: 不同于粗暴截断，AI 生成的结构化摘要包含「已完成任务」「关键决策」「当前状态」「待办事项」「重要上下文」五大维度
2. 安全可控: 自动备份原始会话到 memory/compressed/，支持完整恢复；--replace 操作需显式触发
3. 零外部依赖: 纯 Bash 实现，仅依赖系统标准工具（jq、openclaw CLI），供应链攻击面为零
4. 灵活配置: 支持设置压缩阈值（50-99%）、摘要深度（brief/balanced/comprehensive）、静默时段
5. 会话连续性保持: 压缩后 session key 不变，仅更新 session ID，用户体验无缝衔接

潜在缺点/局限性

1. 平台绑定: 专属于 OpenClaw 生态，无法迁移至其他 AI 平台
2. Bash 依赖: 需 Linux/macOS 环境，Windows 用户需 WSL
3. 摘要质量波动: AI 生成摘要的质量取决于模型能力，复杂会话可能丢失细节
4. 破坏性操作风险: --replace 虽可恢复，但误操作可能导致上下文中断
5. 无图形界面: 纯命令行工具，对非技术用户门槛较高

适合人群

• 重度 OpenClaw 用户: 日均对话量大的专业用户、开发者、研究人员
• 长会话工作者: 需要维持数小时甚至数天连续对话的复杂项目
• Token 敏感场景: 使用高成本模型或上下文窗口有限的场景
• 自动化运维: 结合 cron 实现 proactive 会话维护

常规风险

1. 操作风险: --replace 为不可逆流程（虽有备份），需确认摘要质量后再执行
2. 摘要完整性: 极端复杂会话可能因 AI 理解偏差导致关键信息遗漏
3. 版本兼容性: 依赖 openclaw CLI，版本变更可能导致功能异常
4. 本地存储: 备份文件占用磁盘空间，需定期清理 memory/compressed/

安全认证显示 S 级/92分，静态分析无危险函数，隐私合规通过，属低风险本地工具。