​

openclaw 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 二维码渲染
• --json：输出 JSON（setupCode、gatewayUrl、auth、urlSource）

​

注意事项

• --token 和 --password 互斥。
• 使用 --remote 时，如果实际生效的远程凭据配置为 SecretRef 且未传入 --token 或 --password，命令会从活动的 Gateway 网关快照中解析。如果 Gateway 网关不可用，命令会快速失败。
• 不使用 --remote 时，当未传入 CLI 认证覆盖参数时，本地 Gateway 网关认证 SecretRef 会被解析：
  • 当令牌认证可以胜出时（显式设置 gateway.auth.mode="token" 或在没有密码源胜出的推断模式下），解析 gateway.auth.token。
  • 当密码认证可以胜出时（显式设置 gateway.auth.mode="password" 或在没有来自 auth/env 的胜出令牌的推断模式下），解析 gateway.auth.password。
• 如果同时配置了 gateway.auth.token 和 gateway.auth.password（包括 SecretRef）且 gateway.auth.mode 未设置，设置码解析会失败，直到显式设置 mode。
• Gateway 网关版本差异说明：此命令路径要求 Gateway 网关支持 secrets.resolve；较旧的 Gateway 网关会返回未知方法错误。
• 扫描后，通过以下命令批准设备配对：
  • openclaw devices list
  • openclaw devices approve <requestId>