node-connect

Diagnose and fix OpenClaw node pairing failures across Android, iOS, and macOS.

14|5|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/openclaw-easy/openclaw-easy-desktop --skill node-connect-openclaw-easy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/openclaw-easy/openclaw-easy-desktop/tree/main/openclaw/skills/node-connect
Command: npx skills add https://github.com/openclaw-easy/openclaw-easy-desktop --skill node-connect-openclaw-easy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose OpenClaw node connection and pairing failures across Android, iOS, and macOS companion apps. Use when QR/setup code/manual connect fails, local Wi-Fi works but VPS/tailnet does not, or errors mention pairing required, unauthorized, bootstrap token invalid or expired, gateway.bind, gateway.remote.url, Tailscale, or plugins.entries.device-pair.config.publicUrl.

Core Features & Use Cases

  • Diagnostic workflow to identify whether the issue is local, LAN, Tailnet, or public URL based.
  • Step-by-step guidance that surfaces canonical checks (gateway.bind, gateway.remote.url, gateway.tailscale, plugin publicUrl) and recommended corrective actions.
  • Guardrails to prevent guesswork, with questions to clarify setup before diagnosing.

Quick Start

Run the node-connect diagnostic to identify and fix a failing OpenClaw pairing by verifying gateway routes and performing the recommended checks.

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 my bootstrap token is invalid or expired?▼

Fix OpenClaw node pairing failures by running canonical checks like `openclaw qr --json` to verify tokens and following guided steps to restore authenticated pairing across your devices.

Why does my OpenClaw local Wi-Fi connection work but my remote gateway or Tailnet access fail?▼

Local Wi-Fi works but remote gateway or Tailnet access fails due to misconfigured routing. Diagnose the issue by checking `gateway.bind`, `gateway.remote.url`, and Tailscale settings to restore correct routes.

How do I diagnose OpenClaw companion app connection issues across Android, iOS, and macOS?▼

Diagnose OpenClaw companion app connection issues across Android, iOS, and macOS by running a diagnostic workflow that identifies whether the failure is local, LAN, Tailnet, or public URL based.

What should I check when OpenClaw returns a pairing required or unauthorized error?▼

When OpenClaw returns a pairing required or unauthorized error, verify `plugins.entries.device-pair.config.publicUrl` and execute `devices list` to identify and correct authentication mismatches.

What is the best way to troubleshoot OpenClaw QR code or manual host port setup failures?▼

The best way to troubleshoot OpenClaw QR code or manual host port setup failures is to run a diagnostic that surfaces canonical gateway checks and provides concrete corrective actions without guesswork.