openclaw qr

현재 게이트웨이 구성에서 iOS 페어링 QR 및 설정 코드를 생성합니다.

사용법

openclaw qr
openclaw qr --setup-code-only
openclaw qr --json
openclaw qr --remote
openclaw qr --url wss://gateway.example/ws

옵션

• --remote: 설정의 gateway.remote.url과 원격 토큰/비밀번호를 사용
• --url <url>: 페이로드에 사용되는 게이트웨이 URL 재정의
• --public-url <url>: 페이로드에 사용되는 퍼블릭 URL 재정의
• --token <token>: 부트스트랩 플로우가 인증하는 게이트웨이 토큰 재정의
• --password <password>: 부트스트랩 플로우가 인증하는 게이트웨이 비밀번호 재정의
• --setup-code-only: 설정 코드만 출력
• --no-ascii: ASCII QR 렌더링 건너뛰기
• --json: JSON 출력 (setupCode, gatewayUrl, auth, urlSource)

참고사항

• --token과 --password는 상호 배타적입니다.
• 설정 코드 자체에는 공유 게이트웨이 토큰/비밀번호가 아닌 수명이 짧은 불투명 bootstrapToken이 포함됩니다.
• --remote 사용 시, 활성 원격 인증 정보가 SecretRef로 구성되어 있고 --token이나 --password를 전달하지 않으면, 활성 게이트웨이 스냅샷에서 해당 값을 확인합니다. 게이트웨이를 사용할 수 없으면 즉시 실패합니다.
• --remote 없이 사용 시, CLI 인증 재정의가 전달되지 않으면 로컬 게이트웨이 인증 SecretRef가 확인됩니다:
  • gateway.auth.token은 토큰 인증이 우선할 수 있을 때 확인됩니다 (명시적 gateway.auth.mode="token" 또는 비밀번호 소스가 우선하지 않는 추론 모드).
  • gateway.auth.password는 비밀번호 인증이 우선할 수 있을 때 확인됩니다 (명시적 gateway.auth.mode="password" 또는 auth/env에서 우선하는 토큰이 없는 추론 모드).
• gateway.auth.token과 gateway.auth.password가 모두 구성되어 있고(SecretRef 포함) gateway.auth.mode가 설정되지 않은 경우, 모드를 명시적으로 설정할 때까지 설정 코드 확인에 실패합니다.
• 게이트웨이 버전 불일치 참고: 이 명령 경로는 secrets.resolve를 지원하는 게이트웨이가 필요합니다. 이전 버전의 게이트웨이는 unknown-method 오류를 반환합니다.
• 스캔 후 다음을 통해 디바이스 페어링을 승인합니다:
  • openclaw devices list
  • openclaw devices approve <requestId>