openclaw qr

Genera un QR de emparejamiento iOS y un código de configuración a partir de tu configuración actual del Gateway.

Uso

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

Opciones

• --remote: usa gateway.remote.url más el token/contraseña remoto de la configuración
• --url <url>: sustituye la URL del gateway usada en el payload
• --public-url <url>: sustituye la URL pública usada en el payload
• --token <token>: sustituye el token del gateway contra el que se autentica el flujo de bootstrap
• --password <password>: sustituye la contraseña del gateway contra la que se autentica el flujo de bootstrap
• --setup-code-only: muestra solo el código de configuración
• --no-ascii: omite el renderizado QR en ASCII
• --json: emite JSON (setupCode, gatewayUrl, auth, urlSource)

Notas

• --token y --password son mutuamente excluyentes.
• El código de configuración ahora lleva un bootstrapToken opaco de corta duración, no el token/contraseña compartido del gateway.
• Con --remote, si las credenciales remotas activas están configuradas como SecretRefs y no pasas --token o --password, el comando las resuelve desde la instantánea activa del gateway. Si el gateway no está disponible, el comando falla inmediatamente.
• Sin --remote, los SecretRefs de autenticación local del gateway se resuelven cuando no se pasa un override de autenticación por CLI:
  • gateway.auth.token se resuelve cuando la autenticación por token puede ganar (gateway.auth.mode="token" explícito o modo inferido donde ninguna fuente de contraseña gana).
  • gateway.auth.password se resuelve cuando la autenticación por contraseña puede ganar (gateway.auth.mode="password" explícito o modo inferido sin token ganador desde auth/env).
• Si tanto gateway.auth.token como gateway.auth.password están configurados (incluyendo SecretRefs) y gateway.auth.mode no está definido, la resolución del código de configuración falla hasta que el modo se establezca explícitamente.
• Nota sobre versiones del gateway: esta ruta de comando requiere un gateway que soporte secrets.resolve; gateways más antiguos devuelven un error de método desconocido.
• Después de escanear, aprueba el emparejamiento del dispositivo con:
  • openclaw devices list
  • openclaw devices approve <requestId>