OpenClaw QR 생성: iOS 페어링 코드 1분 만에 발급하기
새로운 기기를 Gateway에 연결할 때마다 긴 토큰이나 URL을 모바일 화면에서 일일이 입력하느라 고생한 적 있으시죠? 오타 하나라도 나면 처음부터 다시 시작해야 하는 그 번거로움은 개발자라면 누구나 겪어봤을 통증일 거예요. openclaw qr 명령어를 사용하면 이런 과정을 QR 코드 하나로 아주 간단하게 해결할 수 있습니다.
openclaw qr
섹션 제목: “openclaw qr”현재 Gateway 설정을 바탕으로 iOS 페어링 QR 코드와 setup code를 생성합니다.
사용법
섹션 제목: “사용법”openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw qr --url wss://gateway.example/ws --token '<token>'--remote: 설정 파일의gateway.remote.url과 원격 token/password를 사용합니다.--url <url>: 페이로드에 사용될 gateway URL을 직접 지정합니다.--public-url <url>: 페이로드에 사용될 public URL을 직접 지정합니다.--token <token>: 페이로드에 사용할 gateway token을 직접 지정합니다.--password <password>: 페이로드에 사용할 gateway password를 직접 지정합니다.--setup-code-only: setup code만 출력합니다.--no-ascii: ASCII QR 렌더링을 생략합니다.--json: JSON 형식으로 출력합니다 (setupCode,gatewayUrl,auth,urlSource).
참고 사항
섹션 제목: “참고 사항”--token과--password는 동시에 사용할 수 없습니다.--remote옵션을 사용할 때, 활성화된 원격 자격 증명이 SecretRefs로 설정되어 있고--token이나--password를 별도로 전달하지 않으면, 명령어는 활성 gateway 스냅샷에서 이를 해결(resolve)합니다. 만약 gateway를 사용할 수 없는 상태라면 명령어는 즉시 실패합니다.--remote를 사용하지 않을 때, CLI에서 인증 정보를 직접 입력하지 않으면 로컬 gateway 인증 SecretRefs가 다음과 같이 해결됩니다:gateway.auth.token: token 인증이 우선순위를 가질 때(명시적인gateway.auth.mode="token"또는 password 소스가 없을 때 추론된 모드) 해결됩니다.gateway.auth.password: password 인증이 우선순위를 가질 때(명시적인gateway.auth.mode="password"또는 auth/env에서 token 소스가 없을 때 추론된 모드) 해결됩니다.
gateway.auth.token과gateway.auth.password가 모두 설정되어 있고(SecretRefs 포함)gateway.auth.mode가 설정되지 않은 경우, 모드를 명시적으로 설정할 때까지 setup-code 해결이 실패합니다.- Gateway 버전 관련 주의사항: 이 명령어 경로는
secrets.resolve를 지원하는 gateway가 필요합니다. 이전 버전의 gateway에서는 unknown-method 에러가 반환됩니다. - QR 코드를 스캔한 후, 다음 명령어를 통해 기기 페어링을 승인하세요:
openclaw devices listopenclaw devices approve <requestId>
다음 단계
섹션 제목: “다음 단계”OpenClaw Expert
아직 막혀 있나요?
이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.