skills.rest
pertain99
pertain99COMMUNITY
Explore all skills by this author →
GitHub

node-connect

Diagnose and repair OpenClaw node pairing failures using config and QR commands.

1|Updated Apr 10, 2026
Search Tags:#diagnostics#tailscale#openclaw#pairing#qr#node-connect
One-click install
npx skills add https://github.com/pertain99/openclaw-better --skill node-connect-pertain99
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/pertain99/openclaw-better/tree/main/skills/node-connect
Command: npx skills add https://github.com/pertain99/openclaw-better --skill node-connect-pertain99

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose OpenClaw node connection and pairing failures across Android, iOS, and macOS companion apps. Find the real route from node to gateway, verify that the gateway advertisement matches that route, and apply the correct pairing/auth fixes to restore connectivity.

Core Features & Use Cases

  • Identify the active network topology (same machine, same LAN, Tailnet, or public URL) and avoid mixing routes.
  • Perform canonical checks using OpenClaw commands, such as openclaw config get gateway.mode, gateway.bind, gateway.tailscale.mode, gateway.remote.url, gateway.auth.mode; openclaw qr --json; openclaw devices list; openclaw nodes status, to locate root causes.
  • Provide guided root-cause analysis and concrete fix recommendations (e.g., adjusting gateway bindings, regenerating setup codes, or updating token/URL settings) to restore proper pairing.

Quick Start

Begin diagnostics on the affected node to identify the active route, verify gateway visibility, and apply the recommended pairing fix.

Frequently Asked Questions about node-connect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does OpenClaw node pairing fail when connecting companion apps over a local network?▼

OpenClaw node pairing fails when the gateway advertisement does not match the actual route from node to gateway. Diagnosing the active network topology and verifying gateway visibility using openclaw config commands isolates the root cause.

How do I fix OpenClaw QR code pairing issues across Android and iOS?▼

To fix OpenClaw QR code pairing, run openclaw qr --json to report the actual route and check gateway bindings. Adjusting gateway.remote.url and regenerating setup codes restores proper companion app connectivity.

Does OpenClaw pairing work over Tailnet and public URLs?▼

Yes, OpenClaw pairing works across local Wi-Fi, LAN, Tailnet, and public URL scenarios. Identifying the active topology and avoiding mixed routes ensures stable node connections and correct gateway authentication.

What is the best way to diagnose OpenClaw gateway connection failures?▼

The best way to diagnose OpenClaw gateway connection failures is querying gateway settings with openclaw config get and reviewing the devices list. This verifies gateway bindings and auth modes to locate root causes.

OpenClaw node connection not working, what configuration should I check?▼

When OpenClaw node connections fail, check gateway.bind, gateway.tailscale.mode, and gateway.auth.mode. Verifying these configuration values against the active network route helps apply the correct token or URL fixes.

Related Skills

Explore More Software Engineering Skills→
MOODMNKY-LLCMOODMNKY-LLC

node-connect

Diagnose OpenClaw cross-device connection failures using CLI and Tailscale checks.

Community
Advanced
openclaw-easyopenclaw-easy
14

node-connect

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

Community
Advanced
wangqianCAIwangqianCAI

node-connect

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

Community
Intermediate
abhiunixabhiunix
1

node-connect

Diagnose OpenClaw node connection and pairing failures across local, tailnet, and public paths.

Community
Intermediate