OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

QR

openclaw qr

Genera un código QR de vinculación móvil y un código de configuración a partir de la configuración actual de tu Gateway.

bash
openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw qr --url wss://gateway.example/ws

Las aplicaciones oficiales de OpenClaw para iOS y Android se conectan automáticamente cuando los metadatos de su código de configuración coinciden. Si una solicitud permanece pendiente (por ejemplo, para un cliente no oficial o por metadatos que no coinciden), revísala y apruébala:

bash
openclaw devices listopenclaw devices approve <requestId>

Opciones

  • --remote: da preferencia a gateway.remote.url; si esa URL no está definida, recurre a gateway.tailscale.mode=serve|funnel. Ignora publicUrl del Plugin device-pair.
  • --url <url>: reemplaza la URL del Gateway utilizada en la carga útil
  • --public-url <url>: reemplaza la URL pública utilizada en la carga útil
  • --token <token>: reemplaza el token del Gateway con el que se autentica el flujo de arranque
  • --password <password>: reemplaza la contraseña del Gateway con la que se autentica el flujo de arranque
  • --setup-code-only: imprime solo el código de configuración
  • --no-ascii: omite la representación del código QR en ASCII
  • --json: genera JSON (setupCode, gatewayUrl, gatewayUrls opcional, auth, urlSource)

--token y --password son mutuamente excluyentes.

Contenido del código de configuración

El código de configuración contiene un bootstrapToken opaco y de corta duración, no el token ni la contraseña compartidos del Gateway. El flujo de arranque integrado emite:

  • un token principal de node con scopes: []
  • un token de traspaso limitado de operator, restringido a operator.approvals, operator.read, operator.talk.secrets y operator.write

Los ámbitos de modificación de vinculaciones y operator.admin siguen requiriendo una vinculación de operador aprobada por separado o un flujo de token.

Resolución de la URL del Gateway

La vinculación móvil rechaza de forma segura las URL ws:// públicas o de Tailscale para el Gateway: usa Tailscale Serve/Funnel o una URL wss:// del Gateway en esos casos. Las direcciones LAN privadas y los hosts Bonjour .local siguen siendo compatibles mediante ws:// sin cifrar.

Cuando la URL seleccionada del Gateway proviene de gateway.bind=lan, OpenClaw también comprueba las rutas persistentes de tailscale serve status --json. Cualquier raíz HTTPS de Serve que actúe como proxy del puerto local loopback del Gateway activo se incluye como alternativa. El comando QR añade esta alternativa solo para lan; custom y tailnet mantienen sus rutas anunciadas explícitamente. Los clientes actuales de iOS prueban las rutas anunciadas en orden y guardan la primera que sea accesible; el campo heredado url permanece sin cambios para los clientes más antiguos.

Con --remote, se requiere gateway.remote.url o gateway.tailscale.mode=serve|funnel.

Resolución de autenticación (sin --remote)

Cuando no se proporciona una opción de autenticación mediante la CLI, las SecretRefs de autenticación del Gateway local se resuelven de la siguiente manera:

Condición Se resuelve como
gateway.auth.mode="token", o modo inferido sin una fuente de contraseña prevalente gateway.auth.token
gateway.auth.mode="password", o modo inferido sin un token prevalente procedente de la autenticación o del entorno gateway.auth.password
Tanto gateway.auth.token como gateway.auth.password están configurados (incluidas SecretRefs) y gateway.auth.mode no está definido falla; define gateway.auth.mode explícitamente

Resolución de autenticación (--remote)

Si las credenciales remotas activas efectivas están configuradas como SecretRefs y no se proporciona ni --token ni --password, el comando las resuelve a partir de la instantánea activa del Gateway. Si el Gateway no está disponible, el comando falla de inmediato.

Temas relacionados

Was this useful?
On this page

On this page