Команды CLI

qr

Сгенерируйте QR-код для сопряжения с iOS и код настройки из текущей конфигурации вашего шлюза.

Использование

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

Опции

  • --remote: использовать gateway.remote.url плюс удаленный токен/пароль из конфигурации
  • --url <url>: переопределить URL шлюза, используемый в полезной нагрузке
  • --public-url <url>: переопределить публичный URL, используемый в полезной нагрузке
  • --token <token>: переопределить токен шлюза для полезной нагрузки
  • --password <password>: переопределить пароль шлюза для полезной нагрузки
  • --setup-code-only: вывести только код настройки
  • --no-ascii: пропустить ASCII-отображение QR-кода
  • --json: вывести данные в формате JSON (setupCode, gatewayUrl, auth, urlSource)

Примечания

  • --token и --password являются взаимоисключающими.
  • С опцией --remote, если эффективные активные удаленные учетные данные настроены как SecretRefs и вы не передаете --token или --password, команда разрешает их из активного снимка состояния шлюза. Если шлюз недоступен, команда завершается с ошибкой.
  • Без опции --remote, локальные SecretRefs аутентификации шлюза разрешаются, когда не передано переопределение аутентификации через CLI:
    • gateway.auth.token разрешается, когда аутентификация по токену может победить (явный gateway.auth.mode="token" или выведенный режим, где нет победившего источника пароля).
    • gateway.auth.password разрешается, когда аутентификация по паролю может победить (явный gateway.auth.mode="password" или выведенный режим без победившего токена из auth/env).
  • Если настроены и gateway.auth.token, и gateway.auth.password (включая SecretRefs), а gateway.auth.mode не установлен, разрешение кода настройки завершится ошибкой, пока режим не будет установлен явно.
  • Примечание о версиях шлюза: для работы этой команды требуется шлюз, поддерживающий secrets.resolve; более старые шлюзы вернут ошибку неизвестного метода.
  • После сканирования подтвердите сопряжение устройства с помощью:
    • openclaw devices list
    • openclaw devices approve <requestId>

pluginsreset