Genera códigos QR de OpenClaw para iOS en segundos

Configurar tu dispositivo móvil para que se comunique con tu entorno de desarrollo suele ser un proceso lento y propenso a errores. Copiar URLs largas o tokens de seguridad a mano en una pantalla táctil es frustrante y quita tiempo valioso.

Te recomiendo usar el comando openclaw qr para automatizar este paso. Es la forma más directa de vincular tu iPhone con el Gateway sin errores de escritura.

openclaw qr

Genera un código QR de emparejamiento para 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 --token '<token>'

Opciones

• --remote: usa gateway.remote.url más el token o password remoto de la configuración.
• --url <url>: sobrescribe la URL del Gateway usada en el payload.
• --public-url <url>: sobrescribe la URL pública usada en el payload.
• --token <token>: sobrescribe el token del Gateway para el payload.
• --password <password>: sobrescribe el password del Gateway para el payload.
• --setup-code-only: imprime solo el código de configuración.
• --no-ascii: omite la renderización del QR en formato ASCII.
• --json: emite un JSON (setupCode, gatewayUrl, auth, urlSource).

Notas

• --token y --password son mutuamente excluyentes.
• Con --remote, si las credenciales remotas efectivamente activas están configuradas como SecretRefs y no pasas --token o --password, el comando las resuelve desde el snapshot activo del Gateway. Si el Gateway no está disponible, el comando falla rápido.
• Sin --remote, los SecretRefs de autenticación del Gateway local se resuelven cuando no se pasa ninguna anulación de autenticación por CLI:
  • gateway.auth.token se resuelve cuando la autenticación por token puede ganar (modo explícito gateway.auth.mode="token" o modo inferido donde no gana ninguna fuente de password).
  • gateway.auth.password se resuelve cuando la autenticación por password puede ganar (modo explícito gateway.auth.mode="password" o modo inferido sin un token ganador de la configuración o el entorno).
• 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 defina explícitamente.
• Nota sobre la diferencia de versiones del Gateway: este comando requiere un Gateway que soporte secrets.resolve; los 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>

AI Setup Assistant

Próximos pasos

• openclaw devices list
• openclaw devices approve