openclaw qr

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

Kullanım

openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw qr --url wss://gateway.example/ws

Seçenekler

• --remote: gateway.remote.url değerini tercih eder; 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ılar
• --public-url <url>: yükte kullanılan genel URL'yi geçersiz kılar
• --token <token>: bootstrap akışının kimlik doğrulaması yaptığı gateway token'ını geçersiz kılar
• --password <password>: bootstrap akışının kimlik doğrulaması yaptığı gateway parolasını geçersiz kılar
• --setup-code-only: yalnızca kurulum kodunu yazdırır
• --no-ascii: ASCII QR işlemeyi atlar
• --json: JSON çıktısı üretir (setupCode, gatewayUrl, auth, urlSource)

Notlar

• --token ve --password birbirini dışlar.
• Kurulum kodunun kendisi artık paylaşılan gateway token'ını/parolasını değil, opak ve kısa ömürlü bir bootstrapToken taşır.
• Yerleşik kurulum kodu bootstrap'i, güvenilir mobil ilk katılım için birincil node token'ını scopes: [] ile ve sınırlı bir operator devir token'ı ile döndürür.
• Devredilen operator token'ı operator.approvals, operator.read, operator.talk.secrets ve operator.write ile sınırlıdır; eşleştirme değişiklik kapsamları ve operator.admin yine de ayrı bir onaylanmış operator eşleştirmesi veya token akışı gerektirir.
• Mobil eşleştirme, 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 seçeneklerinden birini gerektirir.
• --remote ile, etkin uzak kimlik bilgileri SecretRefs olarak yapılandırılmışsa ve --token ya da --password iletmezseniz, komut bunları etkin gateway anlık görüntüsünden çözer. Gateway kullanılamıyorsa komut hızlıca başarısız olur.
• --remote olmadan, CLI kimlik doğrulama geçersiz kılması iletilmediğinde yerel gateway auth SecretRefs çözülür:
  • gateway.auth.token, token auth kazanabildiğinde çözülür (açık gateway.auth.mode="token" veya hiçbir parola kaynağının kazanmadığı çıkarılmış mod).
  • gateway.auth.password, parola auth kazanabildiğinde çözülür (açık gateway.auth.mode="password" veya auth/env'den kazanan token olmayan çıkarılmış mod).
• Hem gateway.auth.token hem de gateway.auth.password yapılandırılmışsa (SecretRefs dahil) ve gateway.auth.mode ayarlanmamışsa, kurulum kodu çözümlemesi mod açıkça ayarlanana kadar 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.
• Resmi OpenClaw iOS ve Android uygulamaları, kurulum kodu meta verileri eşleştiğinde otomatik olarak bağlanır. Bir istek beklemede kalırsa (örneğin resmi olmayan bir istemci veya eşleşmeyen meta veriler için), şu komutlarla inceleyip onaylayın:
  • openclaw devices list
  • openclaw devices approve <requestId>

İlgili

• CLI referansı
• Eşleştirme