CLIコマンド

qr

現在のGateway設定からiOSペアリングQRとセットアップコードを生成します。

使用方法

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なしの場合、CLI認証の上書きが渡されないとき、ローカルゲートウェイ認証SecretRefsが解決されます:
- gateway.auth.tokenは、トークン認証が有効な場合（明示的なgateway.auth.mode="token"または、パスワードソースが優先されない推論モード）に解決されます。
- gateway.auth.passwordは、パスワード認証が有効な場合（明示的なgateway.auth.mode="password"または、認証/環境変数から優先トークンがない推論モード）に解決されます。
gateway.auth.tokenとgateway.auth.passwordの両方が（SecretRefsを含めて）設定されており、gateway.auth.modeが設定されていない場合、モードが明示的に設定されるまでセットアップコードの解決は失敗します。
ゲートウェイバージョンスキューの注意: このコマンドパスはsecrets.resolveをサポートするゲートウェイが必要です。古いゲートウェイは不明なメソッドエラーを返します。
スキャン後、以下のコマンドでデバイスペアリングを承認します:
- openclaw devices list
- openclaw devices approve <requestId>

plugins reset