# openclaw qr

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

# Penggunaan

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 masih dapat menyediakan URL publik jarak jauh
• --url <url>: timpa URL gateway yang digunakan dalam muatan
• --public-url <url>: timpa URL publik yang digunakan dalam muatan
• --token <token>: timpa token gateway yang digunakan alur inisialisasi untuk autentikasi
• --password <password>: timpa kata sandi gateway yang digunakan alur inisialisasi untuk autentikasi
• --setup-code-only: cetak hanya kode penyiapan
• --no-ascii: lewati perenderan QR ASCII
• --json: hasilkan 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.
• Dalam alur inisialisasi node/operator bawaan, token node utama tetap tersimpan dengan scopes: [].
• Jika serah terima inisialisasi juga menerbitkan token operator, token tersebut tetap dibatasi pada daftar izin inisialisasi: operator.approvals, operator.read, operator.talk.secrets, operator.write.
• Pemeriksaan cakupan inisialisasi berprefiks peran. Daftar izin operator tersebut hanya memenuhi permintaan operator; peran non-operator tetap memerlukan cakupan di bawah prefiks perannya sendiri.
• Pemasangan seluler gagal tertutup untuk URL Gateway ws:// Tailscale/publik. 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 akan menyelesaikannya dari snapshot Gateway aktif. Jika Gateway tidak tersedia, perintah gagal dengan cepat.
• Tanpa --remote, SecretRefs autentikasi Gateway lokal diselesaikan ketika tidak ada penimpaan 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 autentikasi/env).
• Jika gateway.auth.token dan gateway.auth.password sama-sama dikonfigurasi (termasuk SecretRefs) dan gateway.auth.mode belum diatur, penyelesaian kode penyiapan gagal sampai mode diatur secara eksplisit.
• Catatan ketidaksesuaian versi Gateway: jalur perintah ini memerlukan Gateway yang mendukung secrets.resolve; gateway lama mengembalikan kesalahan metode tidak dikenal.
• Setelah memindai, setujui pemasangan perangkat dengan:
  • openclaw devices list
  • openclaw devices approve <requestId>

# Terkait

• Referensi CLI
• Pemasangan