session-health-monitor
بواسطة assistantheinrich-prog
Coding Agents & IDEsموجز
Context window health monitoring for OpenClaw agents — threshold warnings via Telegram, pre-compaction snapshots.
الوصف
ما الذي تفعله هذه المهارة
Monitors context window usage in OpenClaw agent sessions and sends threshold-based warnings via Telegram. When usage is high or compaction is detected, the agent saves key facts and decisions to a daily memory file. Old memory files are archived automatically to prevent directory clutter.
Context compaction is silent by default; this surfaces usage and compaction events in real time and preserves key facts before they disappear from the agent's memory.
متى تستخدمها
- Getting Telegram alerts when an agent context window hits 75%
- Saving decisions and changed files before a long session ends
- Detecting when context was silently compacted mid-task
- Auto-archiving old memory snapshots after a configurable number of days
- Tracking compaction count across a multi-hour automation run
مثال على سير العمل
User asks: check session health and send me a Telegram update
- 1
Runs
bash scripts/context-check.sh --jsonto get current usage percentage and compaction count - 2
Evaluates result: 63% used, 1 compaction detected, YELLOW threshold triggered
- 3
Extracts 3-5 key facts from the current session (decisions made, files changed, blockers)
- 4
Runs
bash scripts/snapshot.shto write facts to today's memory file - 5
Appends footer
📊 63% Context Window | 1x compactedto the outgoing Telegram message
Telegram message sent with context health footer; facts saved to memory/YYYY-MM-DD.md
المتطلبات
- Telegram bot token (obtained from BotFather)
- Telegram chat ID for the target conversation
التثبيت
clawhub install assistantheinrich-prog/session-health-monitorشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.