OpenClaw QRコード生成：iOSデバイスを即座にペアリング

新しいデバイスをセットアップする際、長いトークンやURLをモバイル端末に手入力するのは本当に面倒ですよね。打ち間違いでエラーが出ると、開発のモチベーションも下がってしまいます。

そんな手間を省いて、スムーズにiOSデバイスをペアリングするための便利なコマンド openclaw qr を紹介します。現在の Gateway 設定から QR コードをサッと生成して、セットアップを効率化しましょう。

openclaw 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>: ペイロードで使用する Gateway の URL を上書きします
• --public-url <url>: ペイロードで使用するパブリック URL を上書きします
• --token <token>: ペイロード用の Gateway トークンを上書きします
• --password <password>: ペイロード用の Gateway パスワードを上書きします
• --setup-code-only: セットアップコードのみを表示します
• --no-ascii: ASCII による QR コードの描画をスキップします
• --json: JSON 形式（setupCode, gatewayUrl, auth, urlSource）で出力します

注意事項

• --token と --password は同時には使用できません。
• --remote を使用する場合、有効なリモート認証情報が SecretRefs として設定されており、かつ --token や --password を渡さないときは、アクティブな Gateway スナップショットからそれらを解決します。Gateway が利用できない場合、コマンドは即座に失敗します。
• --remote を使用しない場合、CLI での認証情報の上書きがない限り、ローカルの Gateway 認証 SecretRefs が解決されます：
  • トークン認証が優先される場合（明示的に gateway.auth.mode="token" が設定されている、またはパスワード設定がない場合）、gateway.auth.token が解決されます。
  • パスワード認証が優先される場合（明示的に gateway.auth.mode="password" が設定されている、または環境変数等からトークンが取得できない場合）、gateway.auth.password が解決されます。
• gateway.auth.token と gateway.auth.password の両方が設定されており（SecretRefs を含む）、gateway.auth.mode が未設定の場合、モードが明示的に設定されるまでセットアップコードの解決は失敗します。
• Gateway のバージョンに関する注意：このコマンドの実行には secrets.resolve をサポートする Gateway が必要です。古いバージョンの Gateway では unknown-method エラーが返されます。
• スキャン完了後、以下のコマンドでデバイスのペアリングを承認してください：
  • openclaw devices list
  • openclaw devices approve <requestId>

次のステップ

• デバイス管理の詳細
• Gateway 設定リファレンス

AI Setup Assistant