openclaw-test-heap-leaks

Analyze OpenClaw test heap snapshots to identify memory growth and OOM causes.

4|2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/bitan-del/gods-eye --skill openclaw-test-heap-leaks-bitan-del
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-test-heap-leaks
Source: https://github.com/bitan-del/gods-eye/tree/main/.agents/skills/openclaw-test-heap-leaks
Command: npx skills add https://github.com/bitan-del/gods-eye --skill openclaw-test-heap-leaks-bitan-del

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Investigate and triage test memory growth and OOM scenarios in OpenClaw by collecting and analyzing heap snapshots, enabling precise identification of retained objects versus shared-worker growth.

Core Features & Use Cases

  • Collect repeated .heapsnapshot files across test lanes to establish reproducible memory growth patterns.
  • Compare snapshots from the same worker PID to identify retention vs runtime leaks using the included delta tooling.
  • Isolate hotspots and patch cleanup logic or test scaffolding to reduce footprint in CI and local runs.

Quick Start

Run the heap-leaks skill against a failing test lane to generate before/after snapshots and compare them with the included delta tool.

Frequently Asked Questions about openclaw-test-heap-leaks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose test memory leaks using heap snapshots?

Compare heap snapshots from the same worker PID across multiple test lanes to identify whether memory growth stems from transformed-module retention or runtime leaks.

Why does my pnpm test run go OOM with multiple workers?

Your pnpm test run may go OOM due to shared-worker memory growth or retained objects; collecting repeated .heapsnapshot files helps triage whether the growth is from transformed-module retention or runtime leaks.

How do I compare heap snapshots to find what is retaining memory?

Use the included heap snapshot delta tooling to parse .heapsnapshot files, summarize sizes by type and name, and report top deltas with before/after references to isolate retention hotspots.

Can I use heap snapshot analysis for both local development and CI test runs?

Yes, heap snapshot analysis applies to both CI test runs and local development with pnpm test across multiple workers, collecting .heapsnapshot files to establish reproducible memory growth patterns.

What is the best way to triage OOM causes in OpenClaw tests?

The best way to triage OOM causes in OpenClaw tests is analyzing heap snapshots from the same worker PID to distinguish between transformed-module retention and runtime leaks.

How do I isolate memory hotspots after collecting heap snapshots?

Isolate memory hotspots by comparing before and after heap snapshots from the same PID, then patch cleanup logic or test scaffolding based on the reported top size deltas to reduce footprint.