> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# QR

# `openclaw qr`

Generieren Sie einen QR-Code für die mobile Kopplung und einen Einrichtungscode aus Ihrer aktuellen Gateway-Konfiguration.

## Verwendung

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` bevorzugen; wenn es nicht gesetzt ist, kann `gateway.tailscale.mode=serve|funnel` weiterhin die öffentliche Remote-URL bereitstellen
* `--url <url>`: die im Payload verwendete Gateway-URL überschreiben
* `--public-url <url>`: die im Payload verwendete öffentliche URL überschreiben
* `--token <token>`: überschreiben, gegen welches Gateway-Token der Bootstrap-Ablauf authentifiziert
* `--password <password>`: überschreiben, gegen welches Gateway-Passwort der Bootstrap-Ablauf authentifiziert
* `--setup-code-only`: nur den Einrichtungscode ausgeben
* `--no-ascii`: ASCII-QR-Darstellung überspringen
* `--json`: JSON ausgeben (`setupCode`, `gatewayUrl`, `auth`, `urlSource`)

## Hinweise

* `--token` und `--password` schließen sich gegenseitig aus.
* Der Einrichtungscode selbst trägt jetzt ein opakes, kurzlebiges `bootstrapToken`, nicht das gemeinsame Gateway-Token/Passwort.
* Der integrierte Einrichtungscode-Bootstrap gibt ein primäres `node`-Token mit `scopes: []` sowie ein begrenztes `operator`-Übergabe-Token für vertrauenswürdiges mobiles Onboarding zurück.
* Das übergebene Operator-Token ist auf `operator.approvals`, `operator.read`, `operator.talk.secrets` und `operator.write` begrenzt; Kopplungs-Mutations-Scopes und `operator.admin` erfordern weiterhin eine separate genehmigte Operator-Kopplung oder einen Token-Ablauf.
* Mobile Kopplung schlägt für Tailscale/öffentliche `ws://`-Gateway-URLs geschlossen fehl. Private LAN-Adressen und `.local`-Bonjour-Hosts werden weiterhin über `ws://` unterstützt, aber mobile Routen über Tailscale/öffentlich sollten Tailscale Serve/Funnel oder eine `wss://`-Gateway-URL verwenden.
* Mit `--remote` erfordert OpenClaw entweder `gateway.remote.url` oder
  `gateway.tailscale.mode=serve|funnel`.
* Mit `--remote`, wenn effektiv aktive Remote-Anmeldedaten als SecretRefs konfiguriert sind und Sie weder `--token` noch `--password` übergeben, löst der Befehl sie aus dem aktiven Gateway-Snapshot auf. Wenn der Gateway nicht verfügbar ist, schlägt der Befehl schnell fehl.
* Ohne `--remote` werden lokale Gateway-Auth-SecretRefs aufgelöst, wenn keine CLI-Auth-Überschreibung übergeben wird:
  * `gateway.auth.token` wird aufgelöst, wenn Token-Auth gewinnen kann (explizit `gateway.auth.mode="token"` oder abgeleiteter Modus, bei dem keine Passwortquelle gewinnt).
  * `gateway.auth.password` wird aufgelöst, wenn Passwort-Auth gewinnen kann (explizit `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 Auflösung des Einrichtungscodes fehl, bis der Modus explizit gesetzt wird.
* Hinweis zu Gateway-Versionsabweichungen: Dieser Befehlspfad erfordert einen Gateway, der `secrets.resolve` unterstützt; ältere Gateways geben einen Fehler wegen einer unbekannten Methode zurück.
* Offizielle OpenClaw-iOS- und Android-Apps verbinden sich automatisch, wenn ihre
  Einrichtungscode-Metadaten übereinstimmen. Wenn eine Anfrage ausstehend bleibt (zum Beispiel für einen
  nicht offiziellen Client oder nicht übereinstimmende Metadaten), prüfen und genehmigen Sie sie mit:
  * `openclaw devices list`
  * `openclaw devices approve <requestId>`

## Verwandt

* [CLI-Referenz](/de/cli)
* [Kopplung](/de/cli/pairing)