openclaw qr

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

Penggunaan

openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw 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
• Pemasangan