OpenClaw QR-Code erstellen: iOS-Pairing in Sekunden

Kennst du das? Du hast dein Gateway fertig konfiguriert, aber jetzt musst du die Verbindung auf dein iPhone oder iPad bringen. Niemand hat Lust, kryptische URLs oder ellenlange Auth-Tokens mühsam auf einer Bildschirmtastatur abzutippen.

Mit openclaw qr erledigst du das in Sekunden. Der Befehl generiert dir direkt im Terminal einen QR-Code für das iOS-Pairing, damit du sofort startklar bist.

openclaw qr

Generate an iOS pairing QR and setup code from your current Gateway configuration.

Nutzung

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

Optionen

• --remote: Verwendet gateway.remote.url plus Remote-Token/Passwort aus der Config.
• --url <url>: Überschreibt die Gateway-URL im Payload.
• --public-url <url>: Überschreibt die öffentliche URL im Payload.
• --token <token>: Überschreibt den Gateway-Token für den Payload.
• --password <password>: Überschreibt das Gateway-Passwort für den Payload.
• --setup-code-only: Gibt nur den Setup-Code aus.
• --no-ascii: Überspringt das ASCII-QR-Rendering.
• --json: Gibt JSON aus (setupCode, gatewayUrl, auth, urlSource).

Hinweise

• --token und --password schließen sich gegenseitig aus.
• Mit --remote: Falls aktive Remote-Credentials als SecretRefs konfiguriert sind und du kein --token oder --password übergibst, löst der Befehl diese aus dem aktiven Gateway-Snapshot auf. Falls das Gateway nicht erreichbar ist, bricht der Befehl sofort ab.
• Ohne --remote: Lokale Gateway-Auth SecretRefs werden aufgelöst, wenn kein CLI-Auth-Override übergeben wird:
  • gateway.auth.token wird aufgelöst, wenn Token-Auth gewinnt (explizit gateway.auth.mode="token" oder abgeleiteter Modus, bei dem kein Passwort-Source gewinnt).
  • gateway.auth.password wird aufgelöst, wenn Passwort-Auth gewinnt (explizit gateway.auth.mode="password" oder abgeleiteter Modus ohne gewinnenden 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 Setup-Codes fehl, bis der Modus explizit gesetzt wird.
• Hinweis zur Gateway-Version: Dieser Befehlspfad erfordert ein Gateway, das secrets.resolve unterstützt; ältere Gateways geben einen “unknown-method” Fehler zurück.
• Bestätige nach dem Scannen das Pairing des Geräts mit:
  • openclaw devices list
  • openclaw devices approve <requestId>

Nächste Schritte

• Geräte verwalten
• Gateway Konfiguration

AI Setup Assistant