KokoChat 网关设备配对

要解决什么问题

KokoChat 是 OpenClaw Gateway 的移动端客户端。把一台手机当成「真实 Gateway 设备」接进来，必须走 OpenClaw 官方的 openclaw qr / device-pair 流程：由 Gateway 签发短期 bootstrapToken，手机完成握手后再拿到正式 device token。若技能自行签 token、或直接写 paired.json，会被严谨的 OpenClaw 部署视为后门式配对，风险不在应用层而在信任模型。

NAT 环境下手机还够不到你在内网里的 Gateway。连接码里应使用 KokoChat relay tunnel 地址，而不是把 LAN 或裸公网 Gateway URL 随手发出去。

技能如何工作

在技能目录执行生成逻辑后，流程大致是：拉起 relay tunnel → 运行 openclaw qr → Gateway 签发经签名的 bootstrap 材料 → 你把仅连接码（ fenced 代码块）交给用户，用户在 KokoChat「我 / 配对」粘贴。

用户粘贴后，手机通过官方 device-pair 兑换 token。你这边先 inspect，再决定是否 openclaw devices approve：

• 若设备已是 paired 状态，不要重复 approve；用 openclaw devices list 核对实际 scope 与设备身份。
• 若仍是 pending，在确认是机主本人发起的配对后再 approve。

KokoChat 产品面通常只需 operator.read 与 operator.write（读会话/历史、发消息）。最终 scope 以 Gateway 策略与 OpenClaw 版本为准，配对完成后务必对照列表；超出预期就停手并建议 revoke。

边界与注意点

• 禁止输出原始 gateway.auth.token；禁止生成「仅 token」或自签 setup code。
• 禁止把 scope 扩到 operator.admin、operator.approvals、operator.talk.secrets 等 KokoChat 不需要的权限。
• 禁止改 OpenClaw 内部（例如 message-handler）跳过设备审批；审批走 openclaw devices approve。
• 若用户未从 App 发起配对，引导其打开 KokoChat 配对页，按页内提示安装/生成，或回传你这里生成的连接码。