Node Pairing Rescue Kit

You clicked the pairing code, tried the node again, and it still throws a bootstrap token invalid error at 7:12 AM. You try the next obvious thing, the app returns unauthorized, the public URL still does not answer, and now you are stuck guessing whether the problem is the token, the auth mode, the URL, or the permission path.

Node Pairing Rescue Kit turns that mess into a clean recovery path. It classifies the failure, checks auth precedence, tells the agent whether to regenerate the token, switch connect mode, fix the public URL, request approval, or pause and escalate, then outputs a rescue report, a handoff note, and a verification step so setup gets unstuck without blind retries.

What's Included

• complete self-contained SKILL.md
• auth precedence and failure-class rules
• bootstrap-token refresh flow
• public URL and Tailscale path checklist
• triage report template
• human handoff note template
• verification test prompt
• package validator in tests/validate.py

Why This is Better

• Most troubleshooting docs assume you already know the failure class, this one finds it first.
• Typical retry advice just says "try again," this one changes one variable at a time.
• The default support flow mixes auth and transport issues together, this one separates them.
• Generic setup guides ignore human approval moments, this one generates the handoff.
• Built from real OpenClaw pairing and auth failure patterns, not theory.

Core Capabilities

• Diagnose node pairing failures by error text, transport, and auth mode.
• Classify expired token, unauthorized, permission, URL, and outage cases.
• Route to refresh, retry, handoff, pause, or escalate with one clear decision.
• Generate a concise rescue report the operator can act on immediately.
• Produce a human handoff note when approval or a fresh pairing code is required.
• Verify the fix with a simple first-install test.

Works Well With

• Agent Escalation Manager
• Agent Heartbeat Monitor
• Browser Automation Rescue Kit