Openclaw용 Node Connect

OpenClaw 노드와 컴패니언 앱 간의 연결, 페어링 및 인증 실패를 식별하고 해결하기 위해 설계된 진단 기술입니다.

1yihui

v1.0.0

Apr 28, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install yihui-node-connect

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 yihui-node-connect 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Node Connect란 무엇인가요?

Node Connect는 OpenClaw 생태계의 네트워크 토폴로지 및 인증 핸드셰이크에 초점을 맞춘 Openclaw Skills 라이브러리의 전문 유틸리티입니다. 개발자와 파워 유저에게 노드에서 gateway로의 유일한 실제 경로를 찾기 위한 체계적인 프레임워크를 제공하여, OpenClaw가 Android, iOS 및 macOS의 컴패니언 앱에 해당 경로를 올바르게 알리도록 보장합니다.

로컬 Wi-Fi, Tailscale tailnets 및 공용 리버스 프록시 전반의 구성을 분석함으로써, 이 기술은 설정 실패에 수반되는 추측을 배제합니다. 원활한 연결 라이프사이클을 보장하기 위해 gateway 바인딩, bootstrap 토큰 및 장치 페어링 요청을 확인하는 데 집중합니다.

Node Connect 활용 사례

모바일 앱에서 실패한 QR 코드 스캔 또는 수동 연결 시도 문제 해결.
장치 페어링 중 'unauthorized' 또는 'bootstrap token expired' 오류 해결.
로컬 루프백이 불충분할 때 VPS 또는 Tailscale을 통한 원격 액세스 구성.
동일 머신 에뮬레이터 또는 USB 터널에 대한 네트워크 경로 검증.
OpenClaw gateway 내에서 대기 중인 장치 요청 관리 및 승인.

Node Connect 작동 원리

수정 사항의 교차 오염을 방지하기 위해 네트워크 토폴로지(Local LAN, Tailscale, Public URL 또는 Loopback)를 정의합니다.
OpenClaw CLI를 사용하여 표준 진단 명령을 실행하고 현재 gateway 모드 및 바인드 상태를 검사합니다.
QR JSON 페이로드의 출력을 분석하여 실제 gatewayUrl 및 해당 구성 소스를 식별합니다.
감지된 오류(예: gateway가 loopback에 바인딩됨)를 특정 근본 원인 해결 방법으로 매핑합니다.
새로운 설정 코드를 생성하거나 대기 중인 장치 ID를 승인하여 보안 핸드셰이크를 완료합니다.

Node Connect 설정 가이드

이 기술로 진단을 시작하려면 OpenClaw CLI가 활성 상태인지 확인하고 다음 검사 시퀀스를 실행하십시오.

# 핵심 gateway 구성 확인
openclaw config get gateway.mode
openclaw config get gateway.bind

# 앱의 QR 페이로드 데이터 검사
openclaw qr --json

# 대기 중인 장치 페어링 요청 보기
openclaw devices list

Node Connect 데이터 스키마 및 분류 체계

이 기술은 다음 구성 키 및 시스템 출력을 기반으로 데이터를 해석하고 구성합니다.

Key	설명
`gatewayUrl`	앱이 연결을 시도하는 데 사용하는 엔드포인트.
`urlSource`	어떤 구성 경로(LAN, Tailscale 또는 Public)가 경로를 생성했는지 식별.
`gateway.bind`	gateway가 loopback, LAN 또는 자동 검색에서 수신 대기하는지 결정.
`gateway.auth.mode`	들어오는 노드 요청에 대한 보안 프로토콜 정의.
`pairing_request`	관리자 승인을 기다리는 장치용 임시 메타데이터.