Context Manager - 无感会话切换版

智能上下文管理技能，自动监控上下文使用率，达到阈值时自动保存记忆并创建新会话，用户完全无感知。

🎯 核心特性

⭐ 启动优化（v2.1新功能）⭐⭐⭐⭐⭐

• ✅ 分层读取：核心层<5KB + 摘要层<10KB + 详情QMD检索
• ✅ 启动占用：从40%+降低到<10%（节省75%空间）
• ✅ MEMORY-LITE：精简版记忆（2.5KB），启动专用
• ✅ 启动检测：session_status自动检查，>30%预警

⭐ 无感自动切换（v2.0功能）

• ✅ 自动触发：上下文达到60%自动切换（v2.2.2优化）
• ✅ 零操作：用户无需任何干预
• ✅ 无缝体验：新会话自动加载记忆
• ✅ 自然接续：对话连续，就像没切换

📊 智能监控（v2.2.2优化）⭐⭐⭐⭐⭐

• ✅ 真实API监控：调用OpenClaw API获取会话信息
• ✅ 准确计算：totalTokens / contextTokens = 真实使用率
• ✅ 每5分钟自动检查（v2.2.2优化，原10分钟）
• ✅ 60%阈值提前预警（v2.2.2优化，原85%）
• ✅ 30%阈值启动警告（启动后）
• ✅ 1小时冷却期（避免重复通知）
• ✅ 飞书通知提醒用户
• ✅ 详细日志记录

💾 记忆传递

• ✅ 自动更新MEMORY.md（完整版）
• ✅ 自动更新MEMORY-LITE.md（精简版）
• ✅ 自动更新daily log
• ✅ 保存当前任务状态

🚀 使用方式

超简单 - 零配置

你只需要正常聊天，其他的一切自动完成：

1. 继续对话（监控在后台运行）
2. 达到85%阈值（自动保存记忆）
3. 创建新会话（agentTurn机制）
4. 新会话加载记忆（继续工作）

用户视角：对话从未中断，就像什么都没发生

📋 工作原理

启动流程（v2.1新增）

新会话启动
  ↓
读取核心层（<5KB）
├── SOUL.md（身份）
└── USER.md（用户）
  ↓
读取摘要层（<10KB）
└── MEMORY-LITE.md（精简记忆）
  ↓
启动检测（session_status）
  ↓
Context <10%？✅ 优秀
Context 10-20%？✅ 良好
Context 20-30%？⚠️ 注意
Context >30%？🚨 需要优化
  ↓
需要详情时 → QMD精准检索

会话管理流程

开始对话
  ↓
后台监控（每5分钟）
  ↓
上下文达到85%
  ↓
自动提取会话信息
  ↓
保存到MEMORY.md
  ↓
更新MEMORY-LITE.md
  ↓
更新daily log
  ↓
触发agentTurn
  ↓
创建新会话
  ↓
新会话加载记忆（分层读取）
  ↓
自然继续工作

🔄 无感切换设计

agentTurn消息

{
  "kind": "agentTurn",
  "message": "【无缝接续】请从MEMORY.md加载完整记忆，自然继续对话。不要提及新会话、不要解释切换，就像什么都没发生。继续之前的任务。",
  "deliver": true,
  "channel": "qqbot",
  "to": "USER_ID"
}

新会话行为

• ✅ 自动读取MEMORY.md
• ✅ 加载当前任务进度
• ✅ 自然接续对话
• ❌ 不说"新会话"
• ❌ 不说"已切换"
• ❌ 不说"请继续"

🛠️ 安装配置

安装

# 从ClawHub安装
clawhub install miliger-context-manager

# 或从本地安装
cd ~/.openclaw/skills
tar -xzf context-manager-v2.1.0.tar.gz
cd context-manager
bash install.sh

配置定时任务

# 添加到crontab（每10分钟检查）
*/10 * * * * ~/.openclaw/skills/context-manager/scripts/seamless-switch.sh

自定义阈值

# 编辑脚本，修改阈值
DIALOG_THRESHOLD=85    # 对话中阈值（85%触发切换）
STARTUP_THRESHOLD=30   # 启动后阈值（30%警告）

创建MEMORY-LITE.md

# 手动创建精简版记忆（<10KB）
# 从MEMORY.md提取核心内容：
# - 用户画像（<1KB）
# - 当前状态（<1KB）
# - 关键决策（<3KB）
# - 待办事项（<1KB）
# - 核心洞察（<2KB）

📊 性能指标

指标	目标	实际
检测延迟	< 10分钟	10分钟 ✅
记忆保存	< 5秒	< 5秒 ✅
切换时间	< 1秒	即时 ✅
用户感知	零感知	完全无感 ✅

🎯 使用场景

场景1：长时间对话

• 用户：和我聊聊项目管理
• AI：好的，项目管理有...
• [自动切换]
• 用户：继续深入
• AI：刚才说到项目管理...（自然接续）

场景2：多任务处理

• 用户：帮我做旅行客测试
• AI：好的，开始测试...
• [自动切换]
• AI：继续旅行客测试...（任务未中断）

场景3：学习讨论

• 用户：学习系统化思维
• AI：系统化思维是...
• [自动切换]
• AI：继续说系统化思维...（学习继续）

💡 核心优势

启动优化效果（v2.1）

指标	优化前	优化后	提升
启动占用	40%+	<10%	75%+
剩余空间	60%	90%	50%
Token浪费	高	低	节省90%
数据完整性	完整	完整	不丢失

vs 手动切换

特性	手动	自动
用户操作	需要/new	零操作
时机把握	可能忘记	自动检测
记忆连续	需手动保存	自动保存
体验连续性	有中断感	完全无感

vs 其他方案

• ✅ 比"提醒用户"更进一步：直接自动切换
• ✅ 比"外部监控"更智能：内置AI检测
• ✅ 比"手动操作"更便捷：完全自动化
• ✅ 比"全量读取"更高效：分层读取策略 ⭐

🔧 技术实现

双重保险机制

1. 外部监控：定时任务每10分钟检查
2. 内部检测：AI每次回复前检查（未来）

记忆传递系统

当前会话
  ↓
提取关键信息
  ↓
├── MEMORY.md（长期记忆）
├── daily log（工作日志）
└── HEARTBEAT.md（任务进度）
  ↓
新会话加载
  ↓
继续工作

agentTurn机制

• 使用cron tool的agentTurn
• 创建isolated会话
• 自动传递消息
• 新会话自动启动

📝 版本历史

v2.2.2 (2026-03-06 12:15) ⭐⭐⭐⭐⭐

• ✅ 阈值优化：85% → 60%（提前25%预警）
• ✅ 间隔缩短：10分钟 → 5分钟（更快响应）
• ✅ 解决超限问题：防止会话在两次检查之间快速增长
• ✅ 预留缓冲：60%触发，还有40%空间处理
• ✅ 真实限制认知：按GLM-5实际128k限制计算

v2.2.1 (2026-03-06 10:20) ⭐⭐⭐⭐⭐

• ✅ Cron环境修复：添加完整PATH/HOME环境变量
• ✅ 解决定时任务找不到openclaw命令问题
• ✅ 修复监控脚本持续失败问题（09:00-10:00）

v2.2.0 (2026-03-05 13:33) ⭐⭐⭐⭐⭐

• ✅ 真实API监控：调用OpenClaw API获取会话信息
• ✅ 准确计算：totalTokens / contextTokens = 真实使用率
• ✅ 修复假监控：从"数文件"改为"调API"（解决超限问题）
• ✅ 冷却机制：1小时冷却期（避免重复通知）
• ✅ 详细日志：记录会话、模型、tokens信息
• ✅ 监控脚本：scripts/context-monitor.sh

v2.1.0 (2026-03-05 09:11) ⭐⭐⭐⭐⭐

• ✅ 启动优化：分层读取策略
• ✅ MEMORY-LITE：精简版记忆（2.5KB）
• ✅ 启动占用：40%+ → <10%（节省75%）
• ✅ 启动检测：session_status自动检查
• ✅ 双阈值：启动30% + 对话85%

v2.0.0 (2026-03-04) ⭐

• ✅ 无感自动切换：agentTurn创建新会话
• ✅ 零用户干预：完全自动化
• ✅ 无缝体验：对话连续
• ✅ 智能保存：自动提取关键信息
• ✅ 阈值降低：从95%到85%

v1.0.0 (2026-03-03)

• ✅ 基础上下文监控
• ✅ 手动提醒功能
• ✅ 记忆传递系统

🚀 未来规划

短期（本周）

• 实现内部AI检测（每次回复检查）
• 优化agentTurn消息内容
• 完善记忆提取逻辑

中期（本月）

• 智能任务识别（避免关键任务中断）
• 用户自定义配置
• 多会话管理

长期（未来）

• 机器学习预测最佳切换时机
• 会话状态追踪
• 性能优化

📞 技术支持

遇到问题？

1. 查看日志：tail -50 ~/.openclaw/workspace/logs/seamless-switch.log
2. 检查定时任务：crontab -l | grep seamless
3. 验证记忆保存：cat ~/.openclaw/workspace/MEMORY.md

社区资源：

• GitHub: https://github.com/openclaw/openclaw
• Discord: https://discord.com/invite/clawd
• ClawHub: https://clawhub.com

---

Context Manager v2.2.1 - 生产就绪版 让上下文管理完全自动化，从启动到切换全程优化 版本：2.2.1 发布时间：2026-03-06 10:20

核心突破：

• v2.0：无感自动切换（零用户干预）
• v2.1：启动优化（分层读取，节省75%空间）
• v2.2：真实API监控（解决超限问题）⭐⭐⭐⭐⭐
• v2.2.1：Cron环境修复（生产就绪）⭐⭐⭐⭐⭐