Context Manager V2

面向 OpenClaw 的上下文与会话管理 Skill：通过 shell 脚本与定时任务监控上下文使用率，达到 70% 阈值或每 10 次工具调用时保存记忆文件并自动创建新会话，实现无感切换，含冷却与启动分层加载优化。

zhaog100

热度 19.88

最近更新 2026-03-20 16:11:51

分类：自动化依赖：代码执行 / 读写文件应用场景：工作流 / 自动化脚本 / 任务管理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add sjykj-context-manager-v2

Metadata

name: context-manager
description: Auto context management with seamless session switching. Monitors usage, triggers at 70% threshold (proactive check every 10 tool calls), automatically creates new session with loaded memory. Zero user intervention required. Trigger on "context", "memory", "session management", "context limit", "memory transfer".
version: 2.4.1

Context Manager v2.2 - 无感会话切换

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

🎯 核心特性

启动优化：分层读取（核心<5KB + 摘要<10KB + QMD检索），启动占用<10%
无感自动切换：70%阈值自动触发agentTurn创建新会话
主动保存：每10次工具调用后自动检查上下文，不等阈值
真实API监控：totalTokens/contextTokens准确计算，每5分钟检查
记忆传递：自动更新MEMORY.md + MEMORY-LITE.md + daily log
冷却机制：1小时冷却期，避免重复通知

📋 工作流程

启动 → 读SOUL/USER → 读MEMORY-LITE → session_status检测（>30%预警）
对话中 → 每10次工具调用主动检查 + 每5分钟定时监控 → ≥70%自动保存记忆 → agentTurn新会话 → 分层加载 → 自然继续

🚀 使用方式

# 安装
clawhub install miliger-context-manager

# 配置定时任务
*/5 * * * * ~/.openclaw/skills/context-manager/scripts/seamless-switch.sh

# 查看日志
tail -50 ~/.openclaw/workspace/logs/seamless-switch.log

🔧 阈值配置

DIALOG_THRESHOLD=70   # 对话中触发切换（原85%，降低到70%提前保护）
STARTUP_THRESHOLD=30  # 启动后警告

📊 版本里程碑

v2.0：无感自动切换（agentTurn）
v2.1：启动优化（分层读取，节省75%空间）
v2.2：真实API监控（70%阈值，5分钟间隔）
v2.2.2：阈值85→70%，增加每10次工具调用主动检查
v2.2.1：Cron环境修复（生产就绪）

⚠️ 注意

新会话不说"新会话"/"已切换"，自然接续
MEMORY-LITE.md需手动创建（<10KB精简版）
与smart-memory-sync双保险协作

🔄 主动保存机制（Proactive Save）

在对话过程中，除了定时监控外，还应在每10次工具调用后主动检查上下文：

# 在对话流中，每处理10次工具调用后执行：
TOOL_CALL_COUNT=$((TOOL_CALL_COUNT + 1))
if [ $((TOOL_CALL_COUNT % 10)) -eq 0 ]; then
    session_status  # 检查当前上下文占用
    # 如果占用>50%，即使未达阈值也主动保存关键记忆
    # 确保compaction前已有备份
fi

目的：不等阈值触发，提前保护对话上下文，防止compaction丢失信息。

详细技术实现、性能指标、版本历史见 references/skill-details.md

📄 许可证与版权声明

MIT License

免费使用、修改和重新分发时，需注明出处。

出处：

GitHub: https://github.com/zhaog100/openclaw-skills
ClawHub: https://clawhub.com
创建者：小米辣 (PM + Dev)

商业使用授权：

个人/开源：免费
小微企业（<10 人）：¥999/年
中型企业（10-50 人）：¥4,999/年
大型企业（>50 人）：¥19,999/年
源码买断：¥99,999 一次性

详情请查看：LICENSE