CLI commands

QR

openclaw qr

Geçerli Gateway yapılandırmanızdan bir mobil eşleme QR kodu ve kurulum kodu oluşturun.

Kullanım

openclaw qr
openclaw qr --setup-code-only
openclaw qr --json
openclaw qr --remote
openclaw qr --url wss://gateway.example/ws

Seçenekler

  • --remote: gateway.remote.url değerini tercih et; ayarlanmamışsa gateway.tailscale.mode=serve|funnel yine de uzak genel URL'yi sağlayabilir
  • --url <url>: yükte kullanılan gateway URL'sini geçersiz kıl
  • --public-url <url>: yükte kullanılan genel URL'yi geçersiz kıl
  • --token <token>: bootstrap akışının kimlik doğrulaması yaptığı gateway token'ını geçersiz kıl
  • --password <password>: bootstrap akışının kimlik doğrulaması yaptığı gateway parolasını geçersiz kıl
  • --setup-code-only: yalnızca kurulum kodunu yazdır
  • --no-ascii: ASCII QR işlemeyi atla
  • --json: JSON üret (setupCode, gatewayUrl, auth, urlSource)

Notlar

  • --token ve --password birlikte kullanılamaz.
  • Kurulum kodunun kendisi artık paylaşılan gateway token/parolası yerine opak, kısa ömürlü bir bootstrapToken taşır.
  • Yerleşik düğüm/operatör bootstrap akışında, birincil düğüm token'ı hâlâ scopes: [] ile yerleşir.
  • Bootstrap devri bir operatör token'ı da çıkarırsa, bootstrap izin listesiyle sınırlı kalır: operator.approvals, operator.read, operator.talk.secrets, operator.write.
  • Bootstrap kapsam kontrolleri rol öneklidir. Bu operatör izin listesi yalnızca operatör isteklerini karşılar; operatör olmayan rollerin hâlâ kendi rol önekleri altında kapsamlara ihtiyacı vardır.
  • Mobil eşleme, Tailscale/genel ws:// gateway URL'leri için kapalı şekilde başarısız olur. Özel LAN adresleri ve .local Bonjour ana bilgisayarları ws:// üzerinden desteklenmeye devam eder, ancak Tailscale/genel mobil rotalar Tailscale Serve/Funnel veya bir wss:// gateway URL'si kullanmalıdır.
  • --remote ile OpenClaw, gateway.remote.url veya gateway.tailscale.mode=serve|funnel değerlerinden birini gerektirir.
  • --remote ile, fiilen etkin uzak kimlik bilgileri SecretRef olarak yapılandırılmışsa ve --token ya da --password geçmezseniz komut bunları etkin gateway anlık görüntüsünden çözer. Gateway kullanılamıyorsa komut hızlı şekilde başarısız olur.
  • --remote olmadan, CLI kimlik doğrulama geçersiz kılması geçirilmediğinde yerel gateway kimlik doğrulama SecretRef'leri çözülür:
    • gateway.auth.token, token kimlik doğrulaması kazanabildiğinde çözülür (açık gateway.auth.mode="token" veya hiçbir parola kaynağının kazanmadığı çıkarımlı mod).
    • gateway.auth.password, parola kimlik doğrulaması kazanabildiğinde çözülür (açık gateway.auth.mode="password" veya auth/env'den kazanan token olmayan çıkarımlı mod).
  • Hem gateway.auth.token hem de gateway.auth.password yapılandırılmışsa (SecretRef'ler dahil) ve gateway.auth.mode ayarlanmamışsa, mod açıkça ayarlanana kadar kurulum kodu çözümlemesi başarısız olur.
  • Gateway sürüm uyumsuzluğu notu: bu komut yolu secrets.resolve destekleyen bir gateway gerektirir; eski gateway'ler bilinmeyen yöntem hatası döndürür.
  • Taradıktan sonra cihaz eşlemesini şununla onaylayın:
    • openclaw devices list
    • openclaw devices approve <requestId>

İlgili