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-monitorCLI 명령을 실행하거나, 프롬프트를 Claude Code, Cursor, Codex 등 사용하는 코딩 에이전트에 붙여넣으세요.