agent-health-diagnostics
Installation
SKILL.md
Agent Health Diagnostics
Scripts available in the Collective Skills repo
Overview
When an OpenClaw agent misbehaves — spamming messages, going dark, burning API credits, or looping on dead channels — this skill provides the diagnostic playbook. Covers the 4 most common failure modes with exact commands to diagnose and fix each one.
Battle-tested across a 6-agent deployment spanning 3 hosts (Windows + Linux + Proxmox).
When to Use This Skill
Use when you observe any of these symptoms:
- Agent sending repeated heartbeat/status messages to Telegram/Discord/etc.
- Agent goes silent despite gateway showing "active"
- Logs show
429 Too many tokensorrate_limiterrors - Channel connection loops:
auto-restart attempt 1/10,2/10, etc. - Memory search errors:
input length exceeds context length - Gateway says "active" but agent doesn't respond to messages