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.urldeğerini tercih et; ayarlanmamışsagateway.tailscale.mode=serve|funnelyine 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
--tokenve--passwordbirlikte kullanılamaz.- Kurulum kodunun kendisi artık paylaşılan gateway token/parolası yerine opak, kısa ömürlü bir
bootstrapTokentaşı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.localBonjour ana bilgisayarlarıws://üzerinden desteklenmeye devam eder, ancak Tailscale/genel mobil rotalar Tailscale Serve/Funnel veya birwss://gateway URL'si kullanmalıdır. --remoteile OpenClaw,gateway.remote.urlveyagateway.tailscale.mode=serve|funneldeğerlerinden birini gerektirir.--remoteile, fiilen etkin uzak kimlik bilgileri SecretRef olarak yapılandırılmışsa ve--tokenya da--passwordgeç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.--remoteolmadan, 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çıkgateway.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çıkgateway.auth.mode="password"veya auth/env'den kazanan token olmayan çıkarımlı mod).
- Hem
gateway.auth.tokenhem degateway.auth.passwordyapılandırılmışsa (SecretRef'ler dahil) vegateway.auth.modeayarlanmamış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.resolvedestekleyen 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 listopenclaw devices approve <requestId>