Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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