Ana içeriğe atla

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

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