Skip to main content
現在のゲートウェイ構成に基づいて、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: setupCode, gatewayUrl, auth, urlSource を含む JSON 形式で出力します。

​
補足事項

  • --token と --password は同時には指定できません。
  • --remote を指定し、かつ有効なリモート認証情報が SecretRef として構成されている場合、CLI 上でトークンやパスワードを直接指定しなければ、稼働中のゲートウェイのスナップショットから値が解決されます。ゲートウェイが利用できない場合は即座にエラーとなります。
  • --remote を指定しない場合、CLI での認証情報上書きがなければ、ローカルゲートウェイの認証用 SecretRef が解決されます:
    • gateway.auth.token は、トークン認証が有効（明示的に gateway.auth.mode="token" が設定されているか、他のパスワードソースがない場合）であれば解決されます。
    • gateway.auth.password は、パスワード認証が有効（明示的に gateway.auth.mode="password" が設定されているか、有効なトークンがない場合）であれば解決されます。
  • gateway.auth.token と gateway.auth.password の両方が構成（SecretRef を含む）されており、かつ gateway.auth.mode が未設定の場合、モードが明示的に設定されるまでセットアップコードの解決は行われません。
  • ゲートウェイのバージョンに関する注意: このパスを使用するには、secrets.resolve メソッドをサポートするゲートウェイが必要です。古いバージョンのゲートウェイでは、メソッド未定義エラーが返されます。
  • QR コードをスキャンした後は、以下のコマンドでデバイスのペアリングを承認してください:
    • openclaw devices list
    • openclaw devices approve <requestId>