콘텐츠로 이동
이 페이지는 더 이상 업데이트되지 않습니다. 최신 내용은 OpenClaw 공식 문서에서 확인하세요 →

OpenClaw QR 생성: iOS 페어링 코드 1분 만에 발급하기

새로운 기기를 Gateway에 연결할 때마다 긴 토큰이나 URL을 모바일 화면에서 일일이 입력하느라 고생한 적 있으시죠? 오타 하나라도 나면 처음부터 다시 시작해야 하는 그 번거로움은 개발자라면 누구나 겪어봤을 통증일 거예요. openclaw qr 명령어를 사용하면 이런 과정을 QR 코드 하나로 아주 간단하게 해결할 수 있습니다.

현재 Gateway 설정을 바탕으로 iOS 페어링 QR 코드와 setup code를 생성합니다.

Terminal window
openclaw qr
openclaw qr --setup-code-only
openclaw qr --json
openclaw qr --remote
openclaw 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 list
    • openclaw devices approve <requestId>

AI Setup Assistant

OpenClaw

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.