skills.rest
aayushsoam
aayushsoamCOMMUNITY
Explore all skills by this author →
GitHub

node-connect

Diagnose ClawBot-Plus node connection and pairing failures across routes.

1|Updated Mar 31, 2026
Search Tags:#troubleshooting#tailscale#pairing#qr-code#clawbot#node-connect
One-click install
npx skills add https://github.com/aayushsoam/clawbot-plus --skill node-connect-aayushsoam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/aayushsoam/clawbot-plus/tree/main/skills/node-connect
Command: npx skills add https://github.com/aayushsoam/clawbot-plus --skill node-connect-aayushsoam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose node connection and pairing failures between ClawBot-Plus and 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

  • Routing diagnostics: decide whether the issue is on the same machine, LAN, tailnet, or public URL, and steer the remediation accordingly.
  • Route validation: verify ClawBot-Plus is advertising the correct gateway route and check device pairing state with clawbot-plus devices list.
  • Canonical checks: guide users through deterministic commands to reveal gateway.mode, gateway.bind, and remote URL status, then recommend fixes.
  • Guided remediation: provide a single, concrete action path to restore connection and pairing.

Quick Start

Run the diagnostic to identify the active route and apply the suggested fix.

Frequently Asked Questions about node-connect

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

FAQPage Schema
How do I troubleshoot ClawBot-Plus node connection failures with companion apps?▼

To troubleshoot ClawBot-Plus node connection failures, run routing diagnostics to identify if the issue is local, LAN, tailnet, or public URL, then apply guided remediation steps to restore pairing and connectivity.

Why does my ClawBot-Plus QR code or manual setup pairing fail?▼

QR code or manual setup pairing fails when gateway routes are misconfigured or bootstrap tokens are invalid. Verify device pairing state using clawbot-plus devices list and check gateway.mode and gateway.bind settings to resolve it.

How do I fix node connection issues when local Wi-Fi works but Tailscale or VPS routing does not?▼

Fix remote node connection issues by validating gateway.remote.url status and Tailscale routing. Run canonical checks to ensure the tailnet or public URL is advertising the correct route for your companion app.

What does a bootstrap token invalid or expired error mean during node pairing?▼

A bootstrap token invalid or expired error indicates a remote gateway routing failure. Validate your public URL configuration and device pairing state, then follow concrete remediation paths to refresh the token and restore connection.

Can I diagnose gateway.bind and gateway.remote.url configuration issues without external dependencies?▼

Yes, you can diagnose gateway.bind and gateway.remote.url issues directly. Run deterministic canonical checks to reveal the active route and apply a single, concrete action path to fix the configuration without needing external dependencies.

When should I use node connection troubleshooting for public URL gateway routing?▼

Use node connection troubleshooting when errors mention gateway.remote.url, unauthorized access, or plugins.entries.device-pair.config.publicUrl. It validates public URL advertising and guides remediation for remote companion app connections.

Related Skills

Explore More Software Engineering Skills→
CharlesWiltgenCharlesWiltgen
1.1k

accessibility-diag

Diagnose accessibility issues in iOS/macOS apps with WCAG-aligned checks.

Community
Intermediate
zhcndoczhcndoc

node-connect

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

Official
Intermediate
openclawopenclaw
385.7k

node-connect

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

Official
Intermediate
liutao96liutao96

node-connect

Diagnose OpenClaw node pairing failures across local, LAN, Tailnet, and public URL setups.

Community
Advanced