The first Windows-specific diagnostic toolkit for OpenClaw. Built during a marathon debugging session that uncovered a 115x performance regression in OpenClaw 2026.5.22.

The Problem

OpenClaw on Windows has unique performance characteristics. Gateway upgrades can introduce event loop degradation (p99 from 0ms to 28s), WhatsApp reconnection storms, stuck background subagents, and provider auth prewarm blocking. No monitoring tooling existed for Windows users.

What It Does

Real-Time Health Monitoring

Background polling every 5 minutes. Checks event loop health, WhatsApp connectivity, Windows Scheduled Task state, and memory pressure. Alerts via WhatsApp when thresholds breach.

Diagnostic Toolkit

Three agent tools:

winhealth_check — instant health snapshot with event loop, channel, and Windows task state
winhealth_diagnostics — full bundle with diagnostic export, logs, status, and channel probes
winhealth_alerts — list, dismiss, or clear health alerts

Windows-Specific Detection

Catches issues that only manifest on Windows:

2026.5.22 provider auth prewarm blocking (30-79s stalls)
CLI tool slowness (20-30x slower than HTTP endpoint)
Stuck background subagents blocking gateway restart
WhatsApp reconnection storms
Scheduled Task stalls

The Tech

Built with the OpenClaw Plugin SDK (definePluginEntry), the plugin registers three tools, two lifecycle hooks, and a configurable background monitor. The companion skill teaches agents how to diagnose and fix common Windows issues.

Stack: OpenClaw SDK, JavaScript ESM, TypeScript for development, plain JS for distribution.

Install

# Skill (agent diagnostics)
openclaw skills install windows-health-monitor

# Plugin (background monitoring)
openclaw plugins install clawhub:@jordan-thirkle/openclaw-winhealth

Windows Health Monitor for OpenClaw