> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# QR

# `openclaw qr`

Buat QR pemasangan seluler dan kode penyiapan dari konfigurasi Gateway Anda saat ini.

## Penggunaan

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw qr
openclaw qr --setup-code-only
openclaw qr --json
openclaw qr --remote
openclaw qr --url wss://gateway.example/ws
```

## Opsi

* `--remote`: utamakan `gateway.remote.url`; jika belum diatur, `gateway.tailscale.mode=serve|funnel` tetap dapat menyediakan URL publik jarak jauh
* `--url <url>`: timpa URL gateway yang digunakan dalam payload
* `--public-url <url>`: timpa URL publik yang digunakan dalam payload
* `--token <token>`: timpa token gateway yang digunakan alur bootstrap untuk autentikasi
* `--password <password>`: timpa kata sandi gateway yang digunakan alur bootstrap untuk autentikasi
* `--setup-code-only`: cetak hanya kode penyiapan
* `--no-ascii`: lewati rendering QR ASCII
* `--json`: keluarkan JSON (`setupCode`, `gatewayUrl`, `auth`, `urlSource`)

## Catatan

* `--token` dan `--password` saling eksklusif.
* Kode penyiapan itu sendiri sekarang membawa `bootstrapToken` buram berumur pendek, bukan token/kata sandi gateway bersama.
* Bootstrap kode penyiapan bawaan mengembalikan token `node` utama dengan `scopes: []` plus token serah terima `operator` terbatas untuk onboarding seluler tepercaya.
* Token operator yang diserahkan dibatasi pada `operator.approvals`, `operator.read`, `operator.talk.secrets`, dan `operator.write`; cakupan mutasi pemasangan dan `operator.admin` tetap memerlukan pemasangan operator terpisah yang disetujui atau alur token.
* Pemasangan seluler gagal tertutup untuk URL Gateway Tailscale/publik `ws://`. Alamat LAN privat dan host Bonjour `.local` tetap didukung melalui `ws://`, tetapi rute seluler Tailscale/publik sebaiknya menggunakan Tailscale Serve/Funnel atau URL Gateway `wss://`.
* Dengan `--remote`, OpenClaw memerlukan `gateway.remote.url` atau
  `gateway.tailscale.mode=serve|funnel`.
* Dengan `--remote`, jika kredensial jarak jauh yang efektif aktif dikonfigurasi sebagai SecretRefs dan Anda tidak meneruskan `--token` atau `--password`, perintah menyelesaikannya dari snapshot gateway aktif. Jika gateway tidak tersedia, perintah gagal cepat.
* Tanpa `--remote`, SecretRefs autentikasi gateway lokal diselesaikan ketika tidak ada timpa autentikasi CLI yang diteruskan:
  * `gateway.auth.token` diselesaikan ketika autentikasi token dapat menang (`gateway.auth.mode="token"` eksplisit atau mode tersimpulkan ketika tidak ada sumber kata sandi yang menang).
  * `gateway.auth.password` diselesaikan ketika autentikasi kata sandi dapat menang (`gateway.auth.mode="password"` eksplisit atau mode tersimpulkan tanpa token pemenang dari auth/env).
* Jika `gateway.auth.token` dan `gateway.auth.password` sama-sama dikonfigurasi (termasuk SecretRefs) dan `gateway.auth.mode` belum diatur, resolusi kode penyiapan gagal hingga mode diatur secara eksplisit.
* Catatan ketidakselarasan versi Gateway: jalur perintah ini memerlukan gateway yang mendukung `secrets.resolve`; gateway lama mengembalikan kesalahan unknown-method.
* Aplikasi iOS dan Android resmi OpenClaw tersambung otomatis ketika metadata kode penyiapannya cocok. Jika permintaan tetap tertunda (misalnya, untuk klien nonresmi atau metadata yang tidak cocok), tinjau dan setujui dengan:
  * `openclaw devices list`
  * `openclaw devices approve <requestId>`

## Terkait

* [Referensi CLI](/id/cli)
* [Pemasangan](/id/cli/pairing)