node-connect

Diagnose CrawClaw node pairing failures across Android, iOS, and macOS.

30|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/qianleigood/crawclaw --skill node-connect-qianleigood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/qianleigood/crawclaw/tree/main/skills/node-connect
Command: npx skills add https://github.com/qianleigood/crawclaw --skill node-connect-qianleigood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes node connection and pairing failures between CrawClaw companion apps (Android, iOS, macOS) and the gateway, especially when QR, setup codes, or manual pairing fails.

Core Features & Use Cases

  • Topology-first troubleshooting approach (same machine, same LAN, Tailnet, public URL)
  • Canonical checks with commands to verify gateway and app configuration
  • Root-cause mapping and guided remediation to a single concrete fix

Quick Start

Explain the exact pairing failure scenario to obtain a concrete diagnosis and fix.

Frequently Asked Questions about node-connect

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

FAQPage Schema
How do I fix CrawClaw node pairing failures when the QR code does not connect?

CrawClaw node pairing failures are fixed by applying topology-first checks across your LAN, Tailnet, or public URL to map the QR code error to a root cause, yielding a single concrete remediation path.

Why does my CrawClaw manual setup fail to connect across different network topologies?

Manual setup fails because network topology dictates connectivity rules. By enforcing topology-aware checks for same machine, same LAN, Tailnet, or public URL configurations, you can identify the exact mismatch and apply the correct setup code or bootstrap token fix.

Can I use a Tailnet public URL to troubleshoot iOS or Android companion app connections?

Yes, you can use a Tailnet public URL to troubleshoot iOS and Android companion app connections. The process verifies gateway and app configuration across these topologies, ensuring bootstrap tokens and setup codes function correctly for remote pairing.

What is the best way to diagnose gateway connection issues on macOS companion apps?

The best way to diagnose macOS gateway connection issues is through canonical checks that verify gateway and app configuration. This method interprets errors canonically based on whether the connection is local or via Tailnet, leading to one specific fix.

When should I use bootstrap tokens instead of QR codes for node connections?

You should use bootstrap tokens instead of QR codes when manual pairing is required or QR scanning fails. The troubleshooting workflow validates bootstrap tokens alongside setup codes to ensure proper gateway authentication across Android, iOS, and macOS platforms.