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

オプション

  • --remote: configから 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 は排他的です。
  • セットアップコードには共有ゲートウェイトークン/パスワードではなく、不透明な短命の bootstrapToken が含まれます。
  • --remote 使用時、有効なリモートクレデンシャルがSecretRefとして設定されており --token または --password を渡さない場合、コマンドはアクティブなゲートウェイスナップショットからそれらを解決します。ゲートウェイが利用できない場合は即座に失敗します。
  • --remote なしの場合、CLI認証オーバーライドが渡されない際にローカルゲートウェイ認証SecretRefが解決されます:
    • gateway.auth.token はトークン認証が有効な場合に解決されます（明示的な gateway.auth.mode="token" または推定モードでパスワードソースが優先されない場合）。
    • gateway.auth.password はパスワード認証が有効な場合に解決されます（明示的な gateway.auth.mode="password" または推定モードでauth/envからの優先トークンがない場合）。
  • gateway.auth.token と gateway.auth.password の両方（SecretRef含む）が設定されており gateway.auth.mode が未設定の場合、modeを明示的に設定するまでセットアップコードの解決は失敗します。
  • ゲートウェイバージョンの互換性に関する注意: このコマンドパスは secrets.resolve をサポートするゲートウェイが必要です。古いゲートウェイでは unknown-method エラーが返されます。
  • スキャン後、以下のコマンドでデバイスペアリングを承認してください:
    • openclaw devices list
    • openclaw devices approve <requestId>
arrow_back
前へ
Plugins
次へ
Reset
arrow_forward