SuperAPI AI 工具集

auth-manager

通用与其它

查看项目

更新于 10-13 16:03

技能介绍

Auth Manager v4.0 是一个平台登录态管理工具,核心目标是统一管理多个平台的登录状态并定期检查其可用性。它统一使用 OpenClaw 内置 browser(profile=openclaw),所有平台共享同一个 Chrome profile。

用途 该工具用于解决多平台、多 agent 场景下的登录态管理问题。所有 agent(如 quant、ops、main 等)共享同一 browser profile,做到一次登录、全部可用,避免出现某个 agent 未登录的情况。OAuth 链式登录(如 Provider-A 依赖 GitHub)可自动继承。

主要能力

  1. 检查登录态(定期 cron):优先级为 curl/CLI 高于内置 browser。方法 A 使用 curl/CLI 快速检查(如 gh auth status、curl API);方法 B 对需要渲染的站点(如 Polymarket、LinuxDo、X、抖音、小红书)使用内置 browser,先 navigate 再 snapshot,根据快照关键词判定:包含 logged_in_indicators 判为 active,包含 login_page_indicators 判为 expired,超时/网络错误判为 error(需与 expired 区分)。每次检查最多 15 秒。
  2. 新平台授权:用内置 browser 打开登录页,截图给用户确认,如需扫码等操作则等待用户确认后再 snapshot 验证。登录成功后 cookie/localStorage/IndexedDB 自动保存在 ~/.openclaw/browser/openclaw/user-data/。
  3. 其他 agent 使用登录态:所有 agent 调用内置 browser 时自动继承登录态,无需额外配置。

使用方式 架构采用单一 Profile 模型:~/.openclaw/browser/openclaw/user-data/ 为唯一 Chrome profile;~/.openclaw/auth-platforms.json 保存平台配置;~/.openclaw/auth-session-state.json 保存检查结果状态。平台配置 JSON 包含 name、check_url、login_url、check_method(browser|curl|cli)、logged_in_indicators、login_page_indicators、enabled 等字段。状态文件包含 checkedAt 及每个平台的 status(active|expired|error)、account、method、detail 等。cron 任务每天 09:00/21:00 执行,过期则推送告警到 DailyNews 群,全部正常则静默。

已知平台特性(9 个,含检查方式与登录方式):

  • GitHub:gh auth status (CLI),账密/OAuth,最可靠。
  • AIXN:curl API,账密,使用 session.json token。
  • Provider-A:curl API,GitHub OAuth,依赖 GitHub 登录态。
  • Polymarket:内置 browser,钱包/OAuth,检查 portfolio 关键词。
  • LinuxDo:内置 browser,账密/OAuth,Cloudflare 站点。
  • X (Twitter):内置 browser,账密,可能有验证码。
  • 小红书:内置 browser,App 扫码/手机号,check 地址为 xiaohongshu.com/user/profile/me。
  • Reddit:内置 browser,账密/OAuth,reCAPTCHA 需人工通过。
  • 抖音创作者:内置 browser,App 扫码,check 地址为 creator.douyin.com/creator-micro/home。

限制与铁律 禁止使用 fbu / fast-browser-use(已废弃);所有 browser 操作统一使用 profile='openclaw';旧 profile 目录 ~/.openclaw/chrome-profiles/<platform>/ 已废弃,仅保留 session.json 供 curl 读取 token/cookie;超时不等于过期,网络问题标记为 error;每个检查最多 15 秒以避免阻塞。v3→v4 迁移说明:旧版每个平台独立 fbu Chrome profile,新版所有平台共享内置 browser profile,内置 browser 已有全部平台的 IndexedDB/cookie 数据,无需手动迁移;旧 chrome-profiles/ 目录已于 2026-03-07 彻底删除,旧 <platform>-session.json 文件也已删除。