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

Gere um QR de pareamento móvel e um código de configuração com base na configuração atual do Gateway.

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

Os aplicativos oficiais do OpenClaw para iOS e Android se conectam automaticamente quando os metadados do código de configuração correspondem. Se uma solicitação permanecer pendente (por exemplo, para um cliente não oficial ou com metadados incompatíveis), revise-a e aprove-a:

bash
openclaw devices listopenclaw devices approve <requestId>

Opções

  • --remote: prioriza gateway.remote.url; recorre a gateway.tailscale.mode=serve|funnel se essa URL não estiver definida. Ignora publicUrl do Plugin device-pair.
  • --url <url>: substitui a URL do Gateway usada na carga útil
  • --public-url <url>: substitui a URL pública usada na carga útil
  • --token <token>: substitui o token do Gateway usado para autenticar o fluxo de inicialização
  • --password <password>: substitui a senha do Gateway usada para autenticar o fluxo de inicialização
  • --setup-code-only: imprime somente o código de configuração
  • --no-ascii: ignora a renderização do QR em ASCII
  • --json: emite JSON (setupCode, gatewayUrl, gatewayUrls opcional, auth, urlSource)

--token e --password são mutuamente exclusivos.

Conteúdo do código de configuração

O código de configuração contém um bootstrapToken opaco e de curta duração, e não o token ou a senha compartilhados do Gateway. O fluxo de inicialização integrado emite:

  • um token node primário com scopes: []
  • um token de transferência operator com escopo limitado a operator.approvals, operator.read, operator.talk.secrets e operator.write

Os escopos de alteração de pareamento e operator.admin ainda exigem um fluxo separado de pareamento aprovado do operador ou de token.

Resolução da URL do Gateway

O pareamento móvel falha de modo seguro para URLs ws:// públicas ou do Tailscale do Gateway: use Tailscale Serve/Funnel ou uma URL wss:// do Gateway nesses casos. Endereços de LAN privada e hosts Bonjour .local continuam compatíveis com ws:// simples.

Quando a URL selecionada do Gateway vem de gateway.bind=lan, o OpenClaw também verifica rotas persistentes de tailscale serve status --json. Qualquer raiz HTTPS do Serve que encaminhe para a porta de local loopback do Gateway ativo é incluída como alternativa. O comando QR adiciona essa alternativa apenas para lan; custom e tailnet mantêm suas rotas anunciadas explicitamente. Os clientes iOS atuais testam as rotas anunciadas em ordem e salvam a primeira que estiver acessível; o campo legado url permanece inalterado para clientes mais antigos.

Com --remote, é necessário definir gateway.remote.url ou gateway.tailscale.mode=serve|funnel.

Resolução da autenticação (sem --remote)

Quando nenhuma substituição de autenticação é fornecida pela CLI, as SecretRefs de autenticação do Gateway local são resolvidas da seguinte forma:

Condição Resolve para
gateway.auth.mode="token" ou modo inferido sem uma fonte de senha predominante gateway.auth.token
gateway.auth.mode="password" ou modo inferido sem um token predominante proveniente da autenticação ou do ambiente gateway.auth.password
gateway.auth.token e gateway.auth.password estão configurados (incluindo SecretRefs) e gateway.auth.mode não está definido falha; defina gateway.auth.mode explicitamente

Resolução da autenticação (--remote)

Se credenciais remotas efetivamente ativas estiverem configuradas como SecretRefs e nem --token nem --password forem fornecidos, o comando as resolverá a partir do instantâneo ativo do Gateway. Se o Gateway estiver indisponível, o comando falhará imediatamente.

Relacionados

Was this useful?
On this page

On this page