CLI commands
QR
openclaw qr
현재 Gateway 구성에서 모바일 페어링 QR과 설정 코드를 생성합니다.
사용법
openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw qr --url wss://gateway.example/ws옵션
--remote:gateway.remote.url을 우선 사용합니다. 설정되어 있지 않아도gateway.tailscale.mode=serve|funnel이 원격 공개 URL을 제공할 수 있습니다.--url <url>: 페이로드에 사용되는 Gateway URL을 재정의합니다.--public-url <url>: 페이로드에 사용되는 공개 URL을 재정의합니다.--token <token>: 부트스트랩 흐름이 인증에 사용할 Gateway 토큰을 재정의합니다.--password <password>: 부트스트랩 흐름이 인증에 사용할 Gateway 비밀번호를 재정의합니다.--setup-code-only: 설정 코드만 출력합니다.--no-ascii: ASCII QR 렌더링을 건너뜁니다.--json: JSON을 내보냅니다(setupCode,gatewayUrl,auth,urlSource).
참고
--token과--password는 함께 사용할 수 없습니다.- 이제 설정 코드 자체에는 공유 Gateway 토큰/비밀번호가 아니라 불투명한 단기
bootstrapToken이 포함됩니다. - 기본 제공 설정 코드 부트스트랩은
scopes: []가 포함된 기본node토큰과 신뢰할 수 있는 모바일 온보딩을 위한 제한된operator핸드오프 토큰을 반환합니다. - 핸드오프된 운영자 토큰은
operator.approvals,operator.read,operator.talk.secrets,operator.write로 제한됩니다. 페어링 변경 범위와operator.admin에는 여전히 별도로 승인된 운영자 페어링 또는 토큰 흐름이 필요합니다. - 모바일 페어링은 Tailscale/공개
ws://Gateway URL에 대해 실패 시 닫힘 방식으로 동작합니다. 사설 LAN 주소와.localBonjour 호스트는ws://를 통해 계속 지원되지만, Tailscale/공개 모바일 경로는 Tailscale Serve/Funnel 또는wss://Gateway URL을 사용해야 합니다. --remote를 사용하는 경우 OpenClaw에는gateway.remote.url또는gateway.tailscale.mode=serve|funnel이 필요합니다.--remote를 사용할 때 실제로 활성화된 원격 자격 증명이 SecretRefs로 구성되어 있고--token또는--password를 전달하지 않으면, 이 명령은 활성 Gateway 스냅샷에서 해당 값을 해석합니다. Gateway를 사용할 수 없으면 명령이 즉시 실패합니다.--remote없이 CLI 인증 재정의가 전달되지 않은 경우 로컬 Gateway 인증 SecretRefs가 해석됩니다.gateway.auth.token은 토큰 인증이 우선될 수 있을 때 해석됩니다(명시적gateway.auth.mode="token"또는 비밀번호 소스가 우선되지 않는 추론 모드).gateway.auth.password는 비밀번호 인증이 우선될 수 있을 때 해석됩니다(명시적gateway.auth.mode="password"또는 auth/env에서 우선되는 토큰이 없는 추론 모드).
gateway.auth.token과gateway.auth.password가 모두 구성되어 있고(SecretRefs 포함)gateway.auth.mode가 설정되어 있지 않으면, 모드가 명시적으로 설정될 때까지 설정 코드 해석이 실패합니다.- Gateway 버전 불일치 참고: 이 명령 경로에는
secrets.resolve를 지원하는 Gateway가 필요합니다. 이전 Gateway는 알 수 없는 메서드 오류를 반환합니다. - 스캔 후 다음으로 기기 페어링을 승인합니다.
openclaw devices listopenclaw devices approve <requestId>
관련 항목
Was this useful?
