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.