node-connect

Diagnose network connectivity, authentication, and pairing failures between OpenClaw nodes and gateways.

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/wangqianCAI/OBI --skill node-connect-wangqiancai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/wangqianCAI/OBI/tree/main/skills/node-connect
Command: npx skills add https://github.com/wangqianCAI/OBI --skill node-connect-wangqiancai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves connectivity, pairing, and authentication failures between OpenClaw nodes and gateways, ensuring a stable communication link across various network topologies.

Core Features & Use Cases

  • Topology Diagnosis: Identifies the specific network environment, such as local Wi-Fi, Tailscale, or public reverse proxies, to apply the correct troubleshooting logic.
  • Pairing Verification: Validates QR code payloads, setup tokens, and pending device requests to ensure secure and successful node registration.
  • Use Case: When a remote node fails to pair with a gateway, use this skill to verify if the gateway is incorrectly bound to loopback and receive actionable steps to reconfigure the network route.

Quick Start

Use the node-connect skill to diagnose why my mobile device cannot pair with the local OpenClaw gateway.

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 and pairing failures with a gateway?

To fix OpenClaw node connection failures, you must diagnose network connectivity, verify gateway configuration, and check device pairing status to ensure successful node-to-gateway communication across different network topologies.

Why does my remote node fail to pair with the local OpenClaw gateway?

Remote node pairing fails when the OpenClaw gateway is incorrectly bound to a loopback network interface, preventing external route advertisement and blocking secure device registration and communication.

Does OpenClaw node troubleshooting work over Tailscale tailnets and public internet configurations?

OpenClaw node troubleshooting works across Tailscale tailnets, local networks, and public internet configurations by identifying the specific network environment to apply the correct connectivity and authentication diagnostic logic.

How to verify QR code payloads and setup tokens for OpenClaw device pairing?

To verify OpenClaw device pairing, validate the QR code payloads, setup tokens, and pending device requests to ensure secure node registration and resolve authentication failures with the gateway.

What are common limitations when diagnosing OpenClaw network route advertisement issues?

Limitations when diagnosing OpenClaw network route issues include incorrect gateway bindings to loopback interfaces, which prevent proper route advertisement and block node-to-gateway communication across diverse deployment scenarios.