openclaw qr

Wygeneruj kod QR parowania mobilnego i kod konfiguracji na podstawie bieżącej konfiguracji Gateway.

Użycie

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

Opcje

• --remote: preferuj gateway.remote.url; jeśli nie jest ustawione, gateway.tailscale.mode=serve|funnel nadal może dostarczyć zdalny publiczny URL
• --url <url>: zastąp URL Gateway używany w ładunku
• --public-url <url>: zastąp publiczny URL używany w ładunku
• --token <token>: zastąp token Gateway, względem którego uwierzytelnia się przepływ bootstrap
• --password <password>: zastąp hasło Gateway, względem którego uwierzytelnia się przepływ bootstrap
• --setup-code-only: wypisz tylko kod konfiguracji
• --no-ascii: pomiń renderowanie kodu QR w ASCII
• --json: emituj JSON (setupCode, gatewayUrl, auth, urlSource)

Uwagi

• --token i --password wzajemnie się wykluczają.
• Sam kod konfiguracji przenosi teraz nieprzezroczysty, krótkotrwały bootstrapToken, a nie współdzielony token/hasło Gateway.
• Wbudowany bootstrap kodu konfiguracji zwraca podstawowy token node z scopes: [] oraz ograniczony token przekazania operator na potrzeby zaufanego wdrażania mobilnego.
• Przekazany token operatora jest ograniczony do operator.approvals, operator.read, operator.talk.secrets i operator.write; zakresy mutacji parowania oraz operator.admin nadal wymagają osobnego zatwierdzonego parowania operatora lub przepływu tokenu.
• Parowanie mobilne kończy się bezpieczną odmową dla adresów URL Gateway ws:// dostępnych przez Tailscale/publicznie. Prywatne adresy LAN i hosty Bonjour .local nadal są obsługiwane przez ws://, ale trasy mobilne przez Tailscale/publiczne powinny używać Tailscale Serve/Funnel albo adresu URL Gateway wss://.
• Z --remote OpenClaw wymaga gateway.remote.url albo gateway.tailscale.mode=serve|funnel.
• Z --remote, jeśli faktycznie aktywne zdalne poświadczenia są skonfigurowane jako SecretRefs i nie przekazujesz --token ani --password, polecenie rozwiązuje je z aktywnej migawki Gateway. Jeśli Gateway jest niedostępny, polecenie szybko kończy się błędem.
• Bez --remote lokalne SecretRefs uwierzytelniania Gateway są rozwiązywane, gdy nie przekazano nadpisania uwierzytelniania w CLI:
  • gateway.auth.token jest rozwiązywane, gdy uwierzytelnianie tokenem może wygrać (jawne gateway.auth.mode="token" albo tryb wywnioskowany, w którym nie wygrywa żadne źródło hasła).
  • gateway.auth.password jest rozwiązywane, gdy uwierzytelnianie hasłem może wygrać (jawne gateway.auth.mode="password" albo tryb wywnioskowany bez wygrywającego tokenu z auth/env).
• Jeśli skonfigurowane są zarówno gateway.auth.token, jak i gateway.auth.password (w tym SecretRefs), a gateway.auth.mode nie jest ustawione, rozwiązywanie kodu konfiguracji kończy się błędem, dopóki tryb nie zostanie ustawiony jawnie.
• Uwaga o niezgodności wersji Gateway: ta ścieżka polecenia wymaga Gateway obsługującego secrets.resolve; starsze Gateway zwracają błąd nieznanej metody.
• Oficjalne aplikacje OpenClaw na iOS i Androida łączą się automatycznie, gdy ich metadane kodu konfiguracji pasują. Jeśli żądanie pozostaje oczekujące (na przykład dla nieoficjalnego klienta lub niezgodnych metadanych), przejrzyj je i zatwierdź za pomocą:
  • openclaw devices list
  • openclaw devices approve <requestId>

Powiązane

• Dokumentacja CLI
• Parowanie