PM2 corrupt-state detection

_{playbook · created 2026-07-09 · actor claude-cowork · confidence medium · status active tags: pm2 recovery watchdog}

Symptom: pm2 list shows a daemon online but pid: N/A or cpu/mem stuck at 0 — the PM2 daemon itself is corrupt, not the worker. Full recovery steps live in ~/.openclaw/RUNBOOK.md § "PM2 corruption recovery" (not duplicated here).

Health-check block (run at session start, from RUNBOOK): pm2 list · launchctl print gui/$(id -u)/ai.openclaw.gateway | grep 'pid =' · hermes status · curl 18789 / 18794/api/health / 18790 / 18792.

Watchdog covers this 60s-ly and reads live PIDs from pm2 jlist (post 2026-04-21 patch); growing restart counts in pm2 list = flapping. After any PM2 add/remove/edit: pm2 save.

---

_{Sources: ~/.openclaw/RUNBOOK.md (reviewed 2026-04-28)}