skills.rest
openclaw
openclawOFFICIAL
Explore all skills by this author →
Website𝕏@openclawGitHub

node-connect

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

386k|81.1k|Updated Nov 24, 2025
Search Tags:#troubleshooting#connection#ios#macos#android#openclaw#pairing
One-click install
npx skills add https://github.com/openclaw/openclaw --skill node-connect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/openclaw/openclaw/tree/main/skills/node-connect
Command: npx skills add https://github.com/openclaw/openclaw --skill node-connect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users diagnose and resolve problems when their OpenClaw companion apps cannot connect to the main gateway, covering scenarios like QR code scanning failures, pairing errors, and network connectivity issues across different connection methods.

Core Features & Use Cases

  • Connection Troubleshooting: Guides users through identifying the correct network route (local, Tailscale, public URL) for their OpenClaw nodes.
  • Pairing & Authentication Fixes: Addresses common errors such as "pairing required," "bootstrap token invalid," or "unauthorized" by verifying and correcting gateway configuration and device approval status.
  • Use Case: A user is trying to connect their Android phone to OpenClaw running on their home server, but the QR code scan fails with a "pairing required" error. This Skill will help them diagnose if the issue is with the network route, the pairing process, or authentication, and provide steps to fix it.

Quick Start

Use the node-connect skill to help diagnose why my Android app cannot connect to the 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 the "pairing required" error when connecting my Android app to OpenClaw?▼

To fix the "pairing required" error when connecting your Android app to OpenClaw, verify the gateway binding, check the device pairing status, and ensure the QR setup code or manual connection route is correctly configured.

Why does my OpenClaw node connection fail with a "bootstrap token invalid" message?▼

The "bootstrap token invalid" message indicates an authentication failure during OpenClaw node connection. Resolve this by verifying and correcting your gateway configuration and re-checking the authorization tokens.

Can I connect my iOS companion app to OpenClaw through a Tailscale network?▼

Yes, you can connect your iOS companion app to OpenClaw through a Tailscale network. This involves verifying and correcting your Tailscale configurations and remote URLs to ensure proper VPS or Tailnet connectivity.

What should I do if QR code scanning fails during OpenClaw node setup?▼

If QR code scanning fails during OpenClaw node setup, diagnose the issue by identifying the correct network route, such as local Wi-Fi, Tailscale, or a public URL, and then attempt a manual connection instead.

Does OpenClaw node connection troubleshooting support macOS companion apps?▼

Yes, OpenClaw node connection troubleshooting fully supports macOS companion apps alongside iOS and Android. It diagnoses and resolves connection and pairing failures specific to the macOS platform environment.

Related Skills

Explore More Software Engineering Skills→
SafeAI-Lab-XSafeAI-Lab-X
1.0k

node-connect

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

Community
Intermediate
storyclaw-officialstoryclaw-official

node-connect

Diagnoses and resolves OpenClaw node connection and pairing failures across Android, iOS, and macOS companion apps.

Official
Intermediate
vut08905vut08905

node-connect

Diagnose and repair node-to-gateway pairing and routing failures.

Community
Advanced
abhiunixabhiunix
1

node-connect

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

Community
Intermediate