Login Manager

Login Manager（平台登录态管理）

管 4 个平台的登录态：douyin / bilibili / kuaishou / xhs-browse。其他平台（twitter / weibo / zhihu / xianyu / weixin-channel / wx_mp / xhs-publish 等）不走本 skill——各平台专属 skill 自管登录。

支持的平台

用法（Agent 操作步骤）

Step 0 - 显示环境铁律（有头启动前必读）

有头浏览器开在哪个显示上，由进程环境里的 DISPLAY 决定。直接继承当前环境，不做任何手工干预：

• ✅ 直接执行 camoufox-cli --session <platform> --persistent --headed --json open "<URL>"--DISPLAY 已由部署环境配好：Linux 桌面机 = 真桌面（用户在显示器/远程桌面里直接看到）；Docker = 入口脚本设的 Xvfb（用户经 noVNC http://<host>:6080/vnc.html 查看并操作）
• ❌ 禁止给命令手动加 DISPLAY=:N 前缀（历史事故：agent 照过时文档设 DISPLAY=:2，窗口开进没人看得到的虚拟显示，用户以为失败）
• ❌ 禁止自行启动 Xvfb / x11vnc / noVNC，禁止改任何显示配置
• 遇到 display 类报错（cannot open display / Display is not set 等）：说明部署环境的显示栈有问题，报告用户并停止，不要自行绕过或即兴搭方案

Step 1 — 有头打开登录页

camoufox-cli --session <platform> --persistent --headed --json open "<登录页 URL>"

session 名 = 平台 key（douyin / bilibili / kuaishou / xhs-browse），每个平台一个持久化 session。

Step 2 — 通知用户登录并等待确认

告知用户「[平台] 浏览器已打开，请在窗口里手动完成登录，完成后告诉我」。Stop and wait，等用户回复确认，不要盲轮询。3 分钟无回复发超时提示并退出。

Step 3 — 导出 + 验证（用户确认登录后调用）

login-manager --platform <platform>

脚本一条命令闭环：导出 cookie 到临时 → 两层探活验证（cookie 字段 + 平台 pong）→ 通过才 commit 到中央存储 + 导出 UA → close session。验证不过直接 exit 2，不重试（避免风控）。

失败时保留 session：任何错误路径（导出/读取/验证/commit 失败）都不 close session——浏览器进程留着，Agent/用户可在原窗口重试或重登，避免被强制关闭丢登录态又得重新扫码。只有 exit 0 成功路径才 close。脚本内部 camoufox-cli 调用一律带 --headed，与 Step 1 的 open 对齐，避免 daemon 模式冲突重启杀掉 session。

注意事项

并发约束：每平台一个持久化 session，session 名 = 平台 key。同一 platform session 上走 fail-first 队列（同 session 已有命令在跑时新命令直接 fail），不要并发开多个登录流。浏览器类下游 skill（如 xhs-interact）用 --session <平台 key> --persistent 重起无头 session 复用本 skill 落盘的登录态，用完即 close。

重登纪律：不自动重试超过一次——频繁重试有封号风险。cookie 只存 ~/.openclaw/logins/，不进代码 / 日志。profile 丢失 / 指纹错配 → 重建 + 重登录，绝对不允许导入 cookie 造会话。

本技能只负责登录、导出，导出后的Cookie和UA消费按下游技能约定。

背后的原理（供 target=host / target=node 时参考）

主力后端 = target=camoufox，上面命令针对 camoufox。target=host / target=node 只按本 skill 的流程 + 约定走——何时有头 / 探活节奏 / 中央存储路径是后端无关的，照本 skill 执行；不要照搬 camoufox-cli ... 命令，用你当前后端自带的浏览器工具语义登录 + 导出 cookie/UA 即可。

两层探活（_shared/check-session.ts）：

• Tier 1 cookie 关键字段：douyin→sessionid+sid_tt+uid_tt、bilibili→SESSDATA/DedeUserID、kuaishou→webday7/userId/passToken、xhs-browse→web_session。
• Tier 2 平台 pong：bilibili /x/web-interface/nav、kuaishou graphql visionProfileUserList、xhs-browse edith.xiaohongshu.com/api/sns/web/v2/user/me、douyin /aweme/v1/web/history/read/。pong 带 TTL 缓存（批量探活把 N 次 pong 压成 1 次）。
• 签名平台缺 OFB_KEY → SIGN_UNAVAILABLE 仅警告（presence 已过，登录本身成功），不 fail。

中央存储路径约定：

~/.openclaw/logins/<platform>.json     # { platform, cookies: [...], updated_at }（camoufox-cli cookies export 原生格式 = Playwright add_cookies 格式）
~/.openclaw/logins/<platform>.ua.json  # { userAgent, platform, language, ... }（camoufox-cli identity export 输出）

cookie 和 UA 必须同时导出——同一指纹下的 cookie 才不会被风控错配。下游脚本导入时同时读两文件，拼进 HTTP Cookie / User-Agent header。

验证后再 commit：导出到临时文件 → verifyCookies 验过才落中央存储，避免把失效/不完整 cookie 喂给下游。新鲜 pong 不读缓存（登录验证不能用批量探活的 TTL 缓存）。

强制有头手动登录：所有平台一律 --headed，用户在浏览器里手动扫码 / 短信 / 账号密码完成登录。agent 不主动触发登录动作，只开浏览器等用户。

严禁 cookie import 造会话：浏览器操作一律走真实登录后的持久化 session（登录态 + 指纹冻结在 session profile 里），不开临时 session 再 cookies import。xhs a1/websectiga 等设备指纹 cookie 导入到不同指纹的浏览器会话会错配 → 被风控检测。中央存储的 cookie+UA 只给下游脚本做 raw HTTP 抓取用（拼进 header 直接发请求，不经浏览器）。

HTML 登录墙检测（脚本 / 纯 HTTP 用）：下游 raw HTTP fetch 期望 JSON 时，session 失效平台可能返回 HTML 登录页（200 text/html 或 302→login）而非 JSON error，resp.json() 抛乱码错。_shared/relay-sign.ts 的 xhsFetch 已内置登录墙检测（content-type 含 text/html 或 body 以 HTML 标签开头 → 抛 LoginWallError，消息以 SESSION_EXPIRED: 起头），下游捕获后 emit SESSION_EXPIRED + exit 2。新增 raw-HTTP 脚本若不走 xhsFetch 应复用同款检测（正则大小写不敏感）。