skills.rest
PotLock
PotLockOFFICIAL
Explore all skills by this author →
Website𝕏@potlock_GitHub

node-connect

Diagnose and fix FoxFang node connection and pairing failures.

Updated Aug 27, 2026
Search Tags:#troubleshooting#tailscale#gateway#pairing#qr-code#node-connect#foxfang
One-click install
npx skills add https://github.com/PotLock/foxfang --skill node-connect-potlock
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/PotLock/foxfang/tree/main/skills/node-connect
Command: npx skills add https://github.com/PotLock/foxfang --skill node-connect-potlock

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix FoxFang node connection and pairing failures across Android, iOS, and macOS companion apps. This skill helps when QR/setup codes fail, local Wi-Fi works but remote gateway access does not, or errors indicate pairing is required, unauthorized, bootstrap token invalid or expired, gateway.bind, gateway.remote.url, tailscale, or plugins.entries.device-pair.config.publicUrl.

Core Features & Use Cases

  • Diagnose root causes of node-to-gateway connection failures across local, LAN, Tailnet, and public URL scenarios.
  • Guide step-by-step remediation: verify gateway.route, confirm registration, refresh setup codes, re-pair devices, and validate token configurations.
  • Use Case: A developer supports a FoxFang install where the mobile app reports pairing required; this skill guides the technician to re-pair and verify the gateway route.

Quick Start

Run foxfang qr to fetch the current setup payload, then run foxfang devices list and approve the pending device if necessary.

Frequently Asked Questions about node-connect

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

FAQPage Schema
How do I fix a FoxFang node pairing failure when the mobile app reports pairing required?▼

Fix FoxFang node pairing failures by running foxfang qr to fetch the setup payload, checking foxfang devices list for pending devices, and approving the pending device to complete the pairing process.

Why does local Wi-Fi work but remote gateway access fail for my FoxFang node?▼

Remote gateway access fails when gateway.bind, gateway.remote.url, or tailscale configurations are incorrect. Validate the gateway route and authentication settings to restore remote connectivity across LAN and public URL scenarios.

What does an invalid or expired bootstrap token error mean in FoxFang?▼

An invalid or expired bootstrap token error means the device pairing credentials are no longer valid. Refresh the setup codes using foxfang qr --json and re-pair the device to generate a new authenticated token.

How do I diagnose FoxFang gateway connection issues when plugins.entries.device-pair.config.publicUrl errors appear?▼

Diagnose publicUrl configuration errors by performing canonical checks with foxfang qr --json and gateway configuration commands to ensure the public route and authentication are properly validated and aligned.

Can I use Tailscale to troubleshoot FoxFang node connection failures across different network scenarios?▼

Yes, Tailscale is supported for diagnosing node-to-gateway connection failures across local, LAN, and Tailnet scenarios, helping verify gateway.route and confirm proper remote access authentication.

Related Skills

Explore More Software Engineering Skills→
EffortlessMetricsEffortlessMetrics

heal_selftest

Diagnose and repair selftest failures across KERNEL, GOVERNANCE, and OPTIONAL tiers.

Official
Advanced
MaxSaietsMaxSaiets

node-connect

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

Community
Advanced
openclaw-easyopenclaw-easy
14

node-connect

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

Community
Advanced
SafeAI-Lab-XSafeAI-Lab-X
1.0k

node-connect

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

Community
Intermediate