paperclip-resilience
Installation
SKILL.md
paperclip-resilience
Production-grade resilience for AI agents running on Paperclip, orchestrated through OpenClaw.
The Problem
Paperclip agents die silently when providers hit rate limits, sessions crash on gateway restarts, and failed runs leave agents stuck in error state with no recovery path. If you're running agents overnight or in parallel, you need automated recovery — not manual babysitting.
What's Included
| Module | File | Purpose |
|---|---|---|
| Spawn with Fallback | src/spawn-with-fallback.js |
Wraps openclaw session spawn with automatic provider failover. If your primary model 429s, it tries the configured fallback. |
| Model Rotation | src/model-rotation.js |
Tracks fix attempts per PR/task and rotates through models + thinking levels after repeated failures. |
| Run Recovery | src/run-recovery.js |
Detects failed Paperclip heartbeat runs (gateway errors, timeouts, 429s) and re-invokes agents with model fallback. |
| Blocker Routing | src/blocker-routing.js |
Scans agent session transcripts for blocked/stuck signals and routes them to configurable destinations (file, stdout, webhook). |
| Task Injection | src/task-injection.js |
Enriches spawn task descriptions with issue tracking metadata, PR requirements, and UX design checklists before agent execution. |