OpenClaw Relay 与扫码登录协作 SOP（2026-03-06）

一、目标

在 Discord 运维场景下，完成以下能力闭环：

  1. Chrome Relay 稳定接入与回滚保障
  2. 白名单域名自动 attach（减少手动点击）
  3. 遇到登录/验证码时的人机协作（二维码快速转发给人扫码）
  4. 可视化验收与问题分流

二、实现过程（按时间顺序）

1) 先备份，再改造

  • 备份目录：/Users/mark/.openclaw/workspace/backups/relay-20260306-205704
  • 备份内容：
    • openclaw.json.pre-opt
    • chrome-extension.pre-opt.tgz
    • SHA256SUMS.txt

2) 网关与 Relay 参数固化

对 browser.profiles.chrome 做稳定性配置：

  • driver: extension
  • attachOnly: true
  • cdpPort: 18792
  • color: #00AA00

同时清理 stale 配置：

  • 移除 plugins.entries.google-antigravity-auth

3) 扩展能力增强（自动 attach）

修改：~/.openclaw/browser/chrome-extension/background.js

  • 新增白名单自动 attach 逻辑（新开标签/URL 变化触发）
  • 默认白名单：
    • google.com
    • xiaohongshu.com
    • zhihu.com
    • mp.weixin.qq.com

4) 现场验证

  • tabs / snapshot 多次联调通过
  • 处理过 badge ! 后恢复 attach 的场景
  • 在知乎与公众号流程中实测“扫码协作链路”

三、核心规则（执行标准）

Rule A：高风险动作规则

  • 配置改动前必须先备份
  • 优先可回滚路径，禁止裸改无备份

Rule B：扫码协作规则

  • 一旦出现登录/授权/验证码：
    1. 暂停自动流程
    2. 立即提取二维码
    3. 发到 Discord 频道
    4. 等人工确认“已验证”后再继续

Rule C：二维码提取优先级

  1. 优先：DOM/canvas 直接提取原始二维码资源
  2. 次选：元素级截图（selector）
  3. 兜底：整页截图 + 坐标裁剪 + 放大增强

经验结论：静态坐标裁剪不稳定，容易截偏；DOM/canvas 提取稳定性最高。

Rule D：结果回传规则

  • 用户可见回复必须简短、可执行
  • 图像发送优先 message 工具直发频道，避免丢失上下文

四、标准化操作流（可复用）

场景 1：打开目标站点并等待扫码

  1. 打开页面（如 https://mp.weixin.qq.com/）
  2. 检查是否出现登录二维码
  3. 执行“二维码提取优先级”
  4. 发图并提示用户扫码

场景 2：用户确认已登录

  1. 重新 snapshot 确认登录态
  2. 跳转目标页（如知乎主页/创作中心）
  3. 关闭弹窗
  4. 继续后续分析任务

场景 3：用户反馈“二维码不清晰/发错”

  1. 立即承认并重提取，不辩解
  2. 放弃旧方法，切换更高优先级提取
  3. 重新发送并请求确认

五、验收清单（Checklist）

  • 备份存在且可核验
  • Relay 参数已生效（端口可达）
  • 白名单自动 attach 已实现
  • 知乎扫码登录流程打通
  • 公众号扫码登录流程打通
  • 登录后可跳转主页/创作中心并执行操作

六、后续优化建议

  1. 给二维码提取做一个统一函数（DOM→canvas→crop fallback）
  2. 在扩展侧加“当前 attach 状态可视化日志”
  3. 做一份站点级异常分流表（重定向、风控、登录态过期）
  4. 对运营分析任务建立固定模板（账号概览→问题诊断→30天动作）

七、复盘关键词

OpenClaw / Relay / Chrome Extension / Auto-Attach / Zhihu / WeChat MP / QR Login / Human-in-the-loop / SOP