默认模式
像先用你家里现在这套 Gateway 配置来印门票。
Cli 导读
手机配对二维码怎么生成？先搞清 token 和 password 只能二选一
`openclaw qr` 从当前网关配置生成手机配对二维码和设置码。最容易踩的坑是 `--token` 和 `--password` 不能同时用，且当网关同时配置了 token 和 password 且未显式指定模式时，设置码生成会直接失败。如果只需设置码不要二维码，加 `--setup-code-only`。
先讲这一页到底在解决什么
手机配对二维码怎么生成？先搞清 token 和 password 只能二选一
`openclaw qr` 从当前网关配置生成手机配对二维码和设置码。最容易踩的坑是 `--token` 和 `--password` 不能同时用，且当网关同时配置了 token 和 password 且未显式指定模式时，设置码生成会直接失败。如果只需设置码不要二维码，加 `--setup-code-only`。
第一站
🎟️ 先把 4 个常用命令看成 4 种出票方式
官方示例看起来像几行普通命令，其实就是四种发门票的方法。
openclaw qr像按默认规则直接打印一张标准门票，二维码和 setup code 都给你。
openclaw qr --setup-code-only像说：“图我不要了，只把那串入场号码抄给我。”
openclaw qr --json像不是给人看海报，而是把门票信息整整齐齐装进一个数据盒子里，方便别的程序接着处理。
openclaw qr --remote像对打印机说：“这次别印本地门票，改印远程会场那边的门票。”
第二站
🗺️ --url、--public-url、--remote，其实都在回答“门票上印哪一个地址”
二维码里最怕印错的就是地址。扫了码，却跑去错误的门，那后面什么都对不上。
--remote
像改成拿远程会场的地址和通行证来出票。
--url / --public-url
像你觉得默认印刷地址不对，于是亲手把门票上的门牌和公开入口改掉。
一句话
这些参数都在决定“扫完以后手机会往哪扇门走”。
第三站
🔐 --token 和 --password 在干嘛？是在决定门票背后夹哪种通行证
官方专门提醒这两个参数互斥，因为同一张门票背后，不该同时塞两张不同的通行证。
--token像在门票背后夹一张“令牌通行证”。扫完码后，系统拿这张票去和门卫对暗号。
--password像改成夹一张“口令通行证”。
不能两张都夹
因为门口总得按一种规则验票。你同时给两种，反而会乱。
更关键的一句
真正塞进 setup code 的并不是长期共用大钥匙，而是一个短命的 bootstrapToken。这就像一次性入场券，不是把主仓库总钥匙直接印在海报上。
第四站
🧰 --setup-code-only、--no-ascii、--json，是在决定“门票怎么交到你手里”
有时候你要的是海报，有时候只要号码，有时候要给程序接着处理。官方把这些出口都留给你了。
--setup-code-only
只给号码，不画二维码，像只抄门票编号。
--no-ascii
别在终端里画那张黑白方块海报，只输出别的必要信息。
--json
像把门票内容装进一只透明盒子，字段清清楚楚：setupCode、gatewayUrl、auth、urlSource。
一句话
不是门票本身变了，而是交付门票的样子变了。
第五站
🧪 扫完码后为什么还要去 devices？因为扫票只是到门口，放行还要门卫点头
官方最后那句很关键：扫描之后，还是要用 openclaw devices list 和 openclaw devices approve 完成批准。
第一步
手机扫二维码，拿着临时门票跑到门口。
第二步
Gateway 看到门口来了一位新访客，于是把它挂进待审批名单里。
第三步
你再去 devices 那边看名单、点通过，门才真正开。
📌 一句话
qr 负责出票，devices 负责放行。
最后总结
🎈 把 openclaw qr 压成一句话
openclaw qr 就像打印一张给手机用的临时入场门票：决定门票上写哪个 Gateway 地址、夹哪种短期通行证、用二维码还是号码交付，然后把新设备送到门口，等你后面去 /cli/devices 真正审批放行。