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.