qr

这个工具的名字叫 openclaw qr。它的主要工作是帮你制作一个“配对邀请函”。这个邀请函有两种样子：一种是可以用手机摄像头扫一扫的二维码图案，另一种是一串短短的“设置码”数字。有了它们，你的新设备就能安全地找到并连接上你的网关服务器了。

你可以用不同的方式来告诉工具你想要什么。就像点菜一样，你可以在命令后面加上不同的“小要求”：

1. 只要数字密码：如果你只想要那串数字，不想要二维码图案，就加上 --setup-code-only。这就像你只想要冰淇淋，不要上面的糖果。
2. 用机器能懂的话说：加上 --json，工具就会用一套固定的格式（JSON）告诉你所有信息，方便其他程序读取。
3. 从远方发邀请：加上 --remote，工具就会使用你配置好的“远程网关”地址和密码来制作邀请函。
4. 自己指定地址和钥匙：你可以用 --url 指定网关的地址，用 --token 或 --password 指定连接的“钥匙”。注意哦，--token 和 --password 这两把“钥匙”你只能选一把用，不能同时用两把。

在使用的时候，有一些重要的事情要记住：

• 关于“钥匙”的选择：在你的配置文件里，可能同时设置了 gateway.auth.token 和 gateway.auth.password 两把钥匙。如果工具不知道应该用哪一把（也就是 gateway.auth.mode 没有明确设置），它就会犯糊涂，没法生成设置码。你必须明确告诉它用哪一种方式。
• 关于网关的版本：你的“网关”大管家需要是比较新的版本，支持 secrets.resolve 这个功能才行。如果它太旧了，这个命令就会失败。
• 一个重要的步骤：当你的新设备扫描了二维码或输入了设置码后，它只是发出了“我想和你做朋友”的请求。你还需要在电脑上做最后一步批准：
  1. 先用命令 openclaw devices list 看看有哪些新设备在申请。
  2. 找到那个申请，记下它的 requestId。
  3. 再用命令 openclaw devices approve <requestId> 批准它。这样，配对才算真正完成！