skills.rest
AmirulAndalib
AmirulAndalibCOMMUNITY
Explore all skills by this author →
GitHub

node-connect

Diagnose OpenClaw node pairing, routing, and connection failures across network topologies.

Updated Jun 19, 2026
Search Tags:#troubleshooting#tailscale#gateway#openclaw#network diagnostics#node pairing#qr setup
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill node-connect-amirulandalib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/node-connect
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill node-connect-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Mobile and desktop nodes fail to connect to an OpenClaw gateway for many reasons—loopback-only binding, wrong network route, expired setup codes, or unapproved pairing requests—and vague errors like "can't connect" make root causes hard to find. ## Core Features & Use Cases - Topology-First Diagnosis: Classifies the setup as same machine, same LAN, Tailscale tailnet, or public URL before proposing fixes, avoiding mixed-up solutions. - Canonical Config Checks: Uses openclaw qr --json, openclaw config get, and openclaw devices list to read the actual advertised gateway route instead of guessing. - Root-Cause Mapping: Maps specific errors (loopback-only gateway, invalid bootstrap token, unauthorized, pairing required) to concrete fixes like enabling Tailscale Serve or approving pending devices. - Use Case: A user scans a QR code on their Android phone but the app says "bootstrap token invalid or expired"—the Skill identifies the stale setup code, fixes the advertised route, and walks through regenerating the code and approving the device. ## Quick Start Diagnose why my OpenClaw Android app cannot connect to my gateway and tell me the exact 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 OpenClaw node connection failures?▼

First identify your topology: same machine, same LAN, Tailscale tailnet, or public URL. Then run openclaw qr --json to see the actual advertised gatewayUrl and urlSource, and fix the route config so it matches your intended network path.

Why does my OpenClaw app say pairing required?▼

Pairing required means the network route and authentication already worked, but the device is not approved yet. Run openclaw devices list to find the pending request, then approve it with openclaw devices approve using the requestId.

What does bootstrap token invalid or expired mean in OpenClaw?▼

This error means the setup code is stale. Generate a fresh setup code with openclaw qr and rescan it, and always regenerate the code after changing any URL or authentication configuration.

Can OpenClaw nodes connect over Tailscale?▼

Yes, nodes on the same tailnet can connect via gateway.tailscale.mode=serve or gateway.bind=tailnet. If binding to tailnet fails with no tailnet IP found, the gateway host itself is not connected to Tailscale.

Why does openclaw qr show a loopback address?▼

A loopback-only gateway means remote nodes can never reach it, and gateway.bind=auto may still resolve to loopback. For LAN use gateway.bind=lan, for tailnet use Tailscale Serve, and for public access set a real publicUrl or gateway.remote.url.

Related Skills

Explore More Software Engineering Skills→
JEROME-PRAKASH-LJEROME-PRAKASH-L
1

node-connect

Diagnose OpenClaw node pairing, QR setup code, route, and connection failures.

Community
Intermediate
tedtv1007-ctrltedtv1007-ctrl

node-connect

Diagnose OpenClaw node-to-gateway connectivity and pairing failures across network topologies.

Community
Intermediate
awsaws
2.5k

scanning-with-aws-security-agent

Runs full-repository security scans via the AWS Security Agent service and returns ranked findings.

Official
Advanced
InnerScopeHearingInnerScopeHearing

subagent-driven-development

Assign specialized subagents to interdependent tasks with immediate reviews.

Official
Advanced