OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

QR

openclaw qr

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

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

Resmî 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 resmî olmayan bir istemci veya eşleşmeyen meta veriler nedeniyle), isteği inceleyip onaylayın:

bash
openclaw devices listopenclaw devices approve <requestId>

Seçenekler

  • --remote: gateway.remote.url değerini tercih eder; bu URL ayarlanmamışsa gateway.tailscale.mode=serve|funnel değerine geri döner. device-pair Plugin publicUrl değerini yok sayar.
  • --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>: önyükleme akışının kimlik doğrulaması yaptığı Gateway belirtecini geçersiz kılar
  • --password <password>: önyükleme 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 oluşturmayı atlar
  • --json: JSON çıktısı üretir (setupCode, gatewayUrl, isteğe bağlı gatewayUrls, auth, urlSource)

--token ve --password seçenekleri birlikte kullanılamaz.

Kurulum kodunun içeriği

Kurulum kodu, paylaşılan Gateway belirteci/parolası yerine kısa ömürlü, opak bir bootstrapToken taşır. Yerleşik önyükleme akışı şunları verir:

  • scopes: [] içeren birincil node belirteci
  • operator.approvals, operator.read, operator.talk.secrets ve operator.write ile sınırlı, kapsamı belirlenmiş bir operator aktarım belirteci

Eşleştirme değişikliği kapsamları ve operator.admin için hâlâ ayrı olarak onaylanmış bir operatör eşleştirmesi veya belirteç akışı gerekir.

Gateway URL çözümleme

Mobil eşleştirme, Tailscale/genel ws:// Gateway URL'leri için güvenli biçimde başarısız olur: bunlar için Tailscale Serve/Funnel veya bir wss:// Gateway URL'si kullanın. Özel LAN adresleri ve .local Bonjour ana makineleri düz ws:// üzerinden desteklenmeye devam eder.

Seçilen Gateway URL'si gateway.bind=lan değerinden geldiğinde OpenClaw, kalıcı tailscale serve status --json rotalarını da denetler. Etkin Gateway'in local loopback bağlantı noktasına vekâlet eden tüm HTTPS Serve kökleri yedek seçenek olarak eklenir. QR komutu bu yedek seçeneği yalnızca lan için ekler; custom ve tailnet, açıkça duyurdukları rotaları korur. Güncel iOS istemcileri duyurulan rotaları sırayla yoklar ve erişilebilen ilk rotayı kaydeder; eski istemciler için geriye dönük url alanı değişmeden kalır.

--remote kullanıldığında gateway.remote.url veya gateway.tailscale.mode=serve|funnel değerlerinden biri gereklidir.

Kimlik doğrulaması çözümleme (--remote olmadan)

Herhangi bir CLI kimlik doğrulaması geçersiz kılma seçeneği iletilmediğinde, yerel Gateway kimlik doğrulaması SecretRef değerleri aşağıdaki şekilde çözümlenir:

Koşul Çözümlenen değer
gateway.auth.mode="token" veya öncelikli bir parola kaynağı bulunmadan çıkarılan mod gateway.auth.token
gateway.auth.mode="password" veya kimlik doğrulaması/ortamdan öncelikli bir belirteç bulunmadan çıkarılan mod gateway.auth.password
Hem gateway.auth.token hem de gateway.auth.password yapılandırılmışsa (SecretRef değerleri dâhil) ve gateway.auth.mode ayarsızsa başarısız olur; gateway.auth.mode açıkça ayarlanmalıdır

Kimlik doğrulaması çözümleme (--remote ile)

Fiilen etkin uzak kimlik bilgileri SecretRef olarak yapılandırılmışsa ve --token ya da --password iletilmemişse komut, bunları etkin Gateway anlık görüntüsünden çözümler. Gateway kullanılamıyorsa komut hızla başarısız olur.

İlgili konular

Was this useful?
On this page

On this page