node-connect

Diagnose and fix OpenClaw node pairing and gateway connectivity failures.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/0x-wzw/necroswarm --skill node-connect-0x-wzw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/0x-wzw/necroswarm/tree/main/skills/node-connect
Command: npx skills add https://github.com/0x-wzw/necroswarm --skill node-connect-0x-wzw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenClaw experiences node connection and device-pairing failures across Android, iOS, and macOS companion apps. This skill provides structured diagnostics and remediation guidance to restore reliable pairing and gateway connectivity.

Core Features & Use Cases

  • Diagnose gateway status, connectivity, and pairing state across platforms.
  • Guide users through pairing flows (QR or manual) and resolve common errors such as "Pairing required" or "Bootstrap token invalid".
  • Support end-to-end troubleshooting for both local networks and remote VPS/tailscale deployments.

Quick Start

Run the node-connect diagnostic to identify and fix a failing device pairing scenario.

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 pairing failures when the bootstrap token is invalid or expired?▼

To fix OpenClaw node pairing failures from an invalid or expired bootstrap token, run a diagnostic check to validate your gateway status, verify configuration integrity, and re-initiate the QR or manual setup flow.

Why does OpenClaw pairing work on local Wi-Fi but fail over Tailscale or VPS?▼

OpenClaw pairing fails over Tailscale or VPS when gateway.remote.url configurations are mismatched or unreachable. Diagnose gateway connectivity and tailnet routing to restore remote node pairing and end-to-end gateway status.

What does a "pairing required" or "gateway.bind" error mean in OpenClaw?▼

A "pairing required" or "gateway.bind" error indicates broken OpenClaw node authentication or configuration. Troubleshoot by validating gateway status, checking config integrity, and guiding the device through the correct pairing state.

Can I diagnose OpenClaw connection issues across Android, iOS, and macOS?▼

Yes, you can diagnose OpenClaw connection issues across Android, iOS, and macOS companion apps. The diagnostic process validates gateway status and pairing state consistently across all supported platforms.

How do I troubleshoot OpenClaw gateway connectivity when QR setup codes fail?▼

To troubleshoot OpenClaw gateway connectivity when QR setup codes fail, validate the gateway status, verify configuration integrity, and switch to manual pairing entry to bypass QR code reading errors.