A comprehensive diagnostic tool for resolving connection, pairing, and routing failures between OpenClaw gateways and companion apps.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cool-node-connect
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install cool-node-connect using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Node Connect?
Node Connect is a specialized diagnostic workflow designed to bridge the gap between OpenClaw gateways and their companion nodes on Android, iOS, and macOS. It addresses the technical complexities of network topology, ensuring that your Openclaw Skills operate seamlessly across different environments. By analyzing gateway bindings and authentication states, this skill eliminates the guesswork involved when QR codes fail or manual connections time out.
Whether you are deploying on a local network, utilizing Tailscale for secure tunneling, or exposing services via a public reverse proxy, Node Connect identifies the specific failure point in the connection lifecycle. It focuses on finding the one functional route from node to gateway and ensuring the authorization layer is correctly configured to accept new pairings.
Node Connect Use Cases
- Troubleshooting failed QR code or setup code scans on mobile devices.
- Resolving connectivity issues when moving from local Wi-Fi to a VPS or Tailscale network.
- Debugging auth errors such as unauthorized access, expired bootstrap tokens, or gateway binding conflicts.
- Verifying the configuration of remote gateways and public URLs for global access.
How Node Connect Works
- Determines the intended network topology, such as local LAN, Tailscale tailnet, or public reverse proxy.
- Performs canonical configuration checks using CLI commands to inspect gateway modes and binding addresses.
- Analyzes the JSON output of the gateway setup payload to verify the advertised endpoint matches the actual network path.
- Identifies root causes by mapping error messages like gateway.bind loopback issues or pending device requests.
- Recommends specific remediation steps, such as updating configuration keys or approving pending nodes via the CLI.
Node Connect Setup
To diagnose connectivity within your Openclaw Skills environment, use the following CLI commands to gather state information:
# Check the current gateway configuration and advertised URL
openclaw qr --json
# Inspect pending device pairing requests
openclaw devices list
# Verify Tailscale status if using tailnet routing
tailscale status --json
Ensure your gateway is restarted after making changes to gateway.bind or gateway.tailscale.mode for settings to take effect.
Node Connect Data Schema & Taxonomy
The skill analyzes the following data points to determine connection health:
| Attribute | Description |
|---|---|
| gatewayUrl | The endpoint the app attempts to reach, derived from the setup code. |
| urlSource | The configuration source (e.g., lan, tailnet, publicUrl) determining the route. |
| auth.mode | The authentication strategy (e.g., token, tailscale) currently enforced. |
| pairingStatus | The current lifecycle state of a node request (pending, approved, or expired). |
Node Connect Advanced Features
- Support for Tailscale Serve and Funnel mode diagnostics for zero-config remote access.
- Validation of explicit public URL overrides in the device-pair plugin configuration.
- Automated mapping of loopback-only bindings to prevent unreachable remote node states.
- Remote gateway debugging using the --remote flag for multi-instance Openclaw Skills setups.
SKILL.md
Loading
Related Openclaw Skills
Corkboard Dashboard
A real-time visual dashboard for managing actionable pins, multi-track project pipelines, and historical task recovery.
gh-issues
An advanced orchestrator skill that fetches GitHub issues, spawns parallel AI sub-agents to implement fixes, and automatically addresses PR review comments.
AI Instagram Bio Generator
An intelligent automation tool that generates 10 conversion-optimized Instagram bios tailored to your niche using competitor analysis and AI scoring.
AI Podcast Show Notes Generator
An automated workflow that generates ten SEO-optimized show note versions, timestamps, and social media promotion kits for podcast episodes.
AI Landing Page Copy Generator
An automated conversion rate optimization tool that generates 10 high-converting landing page variations based on competitor analysis and proven copywriting frameworks.
Agent Tools
A comprehensive suite of system, network, and file management utilities designed to give AI agents Swiss Army knife capabilities for server maintenance.
Featured*
