openclaw qr

Generiere einen iOS-Pairing-QR-Code und Setup-Code aus deiner aktuellen Gateway-Konfiguration.

Verwendung

openclaw qr
openclaw qr --setup-code-only
openclaw qr --json
openclaw qr --remote
openclaw qr --url wss://gateway.example/ws

Optionen

  • --remote: gateway.remote.url plus Remote-Token/Passwort aus der Konfiguration verwenden
  • --url <url>: Gateway-URL im Payload überschreiben
  • --public-url <url>: Öffentliche URL im Payload überschreiben
  • --token <token>: Überschreiben, welches Gateway-Token der Bootstrap-Flow authentifiziert
  • --password <password>: Überschreiben, welches Gateway-Passwort der Bootstrap-Flow authentifiziert
  • --setup-code-only: Nur den Setup-Code ausgeben
  • --no-ascii: ASCII-QR-Rendering überspringen
  • --json: JSON ausgeben (setupCode, gatewayUrl, auth, urlSource)

Hinweise

  • --token und --password schließen sich gegenseitig aus.
  • Der Setup-Code enthält jetzt ein opakes, kurzlebiges bootstrapToken, nicht das gemeinsame Gateway-Token/-Passwort.
  • Mit --remote: Wenn aktive Remote-Anmeldedaten als SecretRefs konfiguriert sind und du weder --token noch --password übergibst, werden sie aus dem aktiven Gateway-Snapshot aufgelöst. Falls das Gateway nicht erreichbar ist, bricht der Befehl sofort ab.
  • Ohne --remote werden lokale Gateway-Auth-SecretRefs aufgelöst, wenn kein CLI-Auth-Override übergeben wird:
    • gateway.auth.token wird aufgelöst, wenn Token-Auth gewinnen kann (explizites gateway.auth.mode="token" oder abgeleiteter Modus, bei dem keine Passwortquelle gewinnt).
    • gateway.auth.password wird aufgelöst, wenn Passwort-Auth gewinnen kann (explizites gateway.auth.mode="password" oder abgeleiteter Modus ohne gewinnendes Token aus Auth/Env).
  • Wenn sowohl gateway.auth.token als auch gateway.auth.password konfiguriert sind (einschließlich SecretRefs) und gateway.auth.mode nicht gesetzt ist, schlägt die Setup-Code-Auflösung fehl, bis der Modus explizit festgelegt wird.
  • Hinweis zur Gateway-Versionskompatibilität: Dieser Befehlspfad erfordert ein Gateway, das secrets.resolve unterstützt; ältere Gateways geben einen Unknown-Method-Fehler zurück.
  • Nach dem Scannen genehmige das Geräte-Pairing mit:
    • openclaw devices list
    • openclaw devices approve <requestId>