← Back to Skills Marketplace
Session Health Monitor
by
assistantheinrich-prog
· GitHub ↗
· v1.1.0
557
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install session-health-monitor
Description
Context window health monitoring for OpenClaw agents — threshold warnings via Telegram, pre-compaction snapshots, and memory rotation.
Usage Guidance
This skill appears to implement local context monitoring and snapshotting, but before installing you should: (1) review the included scripts yourself, (2) back up ~/.claude/settings.local.json if you plan to run setup-statusline.sh (it will overwrite/add a statusLine entry), (3) be aware the skill does not itself send Telegram messages or require a Telegram token — it only instructs the agent to append footers to messages sent via whatever Telegram integration you already have, and (4) run the installer in a sandbox or with explicit consent to avoid surprising persistent changes. If you do not use Claude Code or do not want the skill to modify ~/.claude, avoid running setup-statusline.sh and use the scripts manually instead.
Capability Analysis
Type: OpenClaw Skill
Name: session-health-monitor
Version: 1.1.0
The skill bundle is designed for OpenClaw agent context window health monitoring and memory management. All scripts and instructions align with this stated purpose, focusing on local file operations within designated memory directories (`~/.openclaw/workspace/memory`, `~/.claude/memory`, `/tmp`). There is no evidence of data exfiltration, unauthorized remote execution, persistence mechanisms, or malicious prompt injection attempts against the agent. The `SKILL.md` instructions guide the agent to extract 'key facts' about its own work and save them to local memory files, and to append status footers to Telegram messages, all of which are benign actions for internal agent management.
Capability Assessment
Purpose & Capability
The scripts and instructions align with the stated goal of monitoring context usage, taking pre-compaction snapshots, rotating memory files, and exposing a statusline. However the SKILL.md mentions 'warnings via Telegram' but the bundled scripts do not implement Telegram network calls or request a Telegram token — the skill expects the agent's existing Telegram messaging tool to be used, which is reasonable but not explicitly documented as a dependency.
Instruction Scope
Runtime instructions ask the agent to append context-footers to outgoing Telegram messages and to modify agent heartbeat loops. The provided setup script (setup-statusline.sh) modifies ~/.claude/settings.local.json to add a statusLine entry and copies a statusline script into ~/.claude — this changes another application's configuration outside the skill's own files, which is scope creep and could surprise users if done without explicit consent.
Install Mechanism
No remote install or downloads are performed (instruction-only with local scripts). The only external dependency is jq for the installer/statusline patches. No network fetches or archives are used, so installation risk is low, but users should still inspect/prompt before running setup-statusline.sh since it writes into home directories.
Credentials
The skill uses sensible, optional environment variables (MEMORY_DIR, KEEP_DAYS, HEALTH_GREEN_MAX, etc.) and local filesystem paths (~/.openclaw, ~/.claude, /tmp). It does not request tokens or secrets in the registry metadata. The use of user home directories for memory and state is proportionate to the purpose.
Persistence & Privilege
Although always:false and no autonomous 'always-on' flag is set, the installer writes a persistent statusline script into ~/.claude and patches settings.local.json, creating persistent behavior across restarts of the Claude Code app. Modifying another tool's settings is a notable privilege and should be done only with explicit user consent and backup.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install session-health-monitor - After installation, invoke the skill by name or use
/session-health-monitor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
**Added Telegram threshold warnings, clarified OpenClaw agent integration, and updated setup instructions.**
- Agents now warn about high context usage directly in Telegram messages via contextual footers at YELLOW/RED thresholds.
- Setup instructions updated for OpenClaw: add shared skill references and message footer logic.
- Statusline integration and Claude Code–specific content removed; focus is on agent loop, Telegram workflow, and OpenClaw support.
- Troubleshooting updated for Telegram footers and shared skill references.
- No script/code changes; documentation only.
v1.0.1
Add shared skill-session-health.md for OpenClaw agent integration
v1.0.0
Initial release: context window statusline, compaction detection, pre-compaction snapshots, memory rotation
Metadata
Frequently Asked Questions
What is Session Health Monitor?
Context window health monitoring for OpenClaw agents — threshold warnings via Telegram, pre-compaction snapshots, and memory rotation. It is an AI Agent Skill for Claude Code / OpenClaw, with 557 downloads so far.
How do I install Session Health Monitor?
Run "/install session-health-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Session Health Monitor free?
Yes, Session Health Monitor is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Session Health Monitor support?
Session Health Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Session Health Monitor?
It is built and maintained by assistantheinrich-prog (@assistantheinrich-prog); the current version is v1.1.0.
More Skills