已登录浏览器会话桥接

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install t3rnel-signed-in-browser
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 t3rnel-signed-in-browser。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Signed-In Browser 技能通过 T3rnel Session Bridge MCP 服务器，将 AI 代理连接到用户现有的浏览器会话。它避免涉及 SSO、MFA、CAPTCHA 和机器人检测的脆弱脚本登录，同时保留对已认证仪表板、管理控制台、工单队列、银行页面及其他受保护应用的访问权限。与冷启动自动化配置不同，此工作流针对用户真实的标签页和账户状态运行。Openclaw Skills 用户可以检查渲染页面、读取无障碍树、操作表单、截取屏幕截图、检查 React 状态、提取计算 CSS、捕获网络活动，以及记录或重放 UI 流程。由于操作可能产生现实影响，该技能强调先读取后写入、对不可逆操作进行明确确认、凭据安全、选择器验证和操作后验证。

应用场景

在需要现有登录状态的仪表板、管理控制台、CRM 系统、工单队列和内部工具中自动执行任务。
绕过脆弱的 SSO、MFA、CAPTCHA 或机器人检测流程，无需维护脚本登录。
读取渲染后的 CSS、检查 React 组件树或分析 Web 应用的实时状态。
填写已认证表单，同时遵守必填字段、最大长度、浏览器验证和页面错误消息。
捕获整页屏幕截图、控制台输出、网络活动或带注释的页面证据。
记录实时 UI 工作流，并将其重放或导出为 Playwright、Puppeteer、Cypress 或 Selenium 代码。
仅在确实需要浏览器渲染时自动化公共页面，否则使用更简单的 fetch 或无头浏览器。
安全验证点击、提交、导航、删除或设置变更是否产生预期结果。

工作原理

判断任务是否需要真实的已认证会话。
连接 T3rnel Session Bridge MCP 服务器，并使用 session_health 检查传输方式。
调用 session_list_tabs 识别目标标签页，只停留在用户指定的标签页。
必要时使用 session_navigate 导航，然后调用 session_snapshot 或 session_read_page 检查实际的无障碍树和页面状态。
根据最近获取的快照数据选择控件，并使用 session_click、session_fill、session_type、session_select 或 session_press 执行交互。
表单失败时重新获取快照，检查 invalid、problem、maxLength 和 required，使用 session_wait 等待条件而不是任意休眠。
对付款、购买、发布、删除、权限变更或账户设置更新等不可逆操作，说明具体动作并等待确认。
绝不生成或输入密码、OTP、卡号或安全答案；让用户主动提供敏感凭据，并在可用时使用扩展的凭据保险库。
每次重要操作后重新获取快照或读取页面，验证预期 URL、横幅、行、确认页面或状态变化。
只有最终页面证据确认结果时才报告成功；工具响应成功本身不能证明页面已改变。

配置指南

将本地 MCP stdio 服务器添加到 MCP 客户端配置，并安装 T3rnel Browser 扩展及原生消息主机。运行 session_health 并确认传输方式为 extension。首次运行时检查“Allow MCP automation”设置。可选环境变量包括 T3RNEL_SESSION_MODE、T3RNEL_SESSION_HEADLESS=1、T3RNEL_SESSION_TIMEOUT_MS、T3RNEL_SESSION_BROWSER 和 T3RNEL_SESSION_PROFILE。Firefox 不提供调试器 API，因此不支持网络捕获、控制台捕获和 PDF 导出。

数据架构

该技能围绕会话、标签页、快照、操作和验证证据组织浏览器状态。会话传输标识 extension、standalone 或 auto 模式；session_list_tabs 返回可用标签页；页面快照用于识别控件、选择器、字段值、验证状态和页面结构；session_read_page 用于读取渲染页面；表单可能提供 required、maxLength、invalid 和 problem。操作记录包括导航、点击、填写、输入、选择、按键、等待、评估和截图。证据包括截图、注释、控制台日志、网络捕获、CSS 提取和 React 检查数据。录制的工作流可列出、检查、停止、重放或导出为 Playwright、Puppeteer、Cypress 或 Selenium 规范。敏感登录数据必须保存在扩展的凭据保险库中。

高级特性

通过本地 stdio MCP 服务器进行真实会话自动化。
T3RNEL_SESSION_MODE
在扩展和独立浏览器传输之间自动回退。
针对高风险操作的安全审批机制。
暴露实际可点击控件的无障碍树快照。
在重试提交前显示验证消息、必填字段和最大长度。
将实时计算 CSS 提取为 styled-components、Tailwind、CSS Modules 和 JSX 等格式。
检查 React 组件树以及运行中的组件属性和状态。
用于渲染应用调试的整页截图、注释、浏览器控制台捕获和网络检查。
UI 会话录制、事件检查、重放以及导出为 Playwright、Puppeteer、Cypress 或 Selenium。
用于诊断中继缺失、选择器不可用、页面缓慢和传输问题的健康检查与条件等待。
清晰区分免费桥接功能与扩展或 Pro-tier 功能。
在不可逆操作前要求确认，并在报告完成前进行基于证据的验证。

name: signed-in-browser description: Drive the browser the user is already signed into, instead of a cold automation profile. Use when a task lives behind a login — a dashboard, an admin console, an internal tool, a ticket queue, a bank or billing page, webmail, a social account — or when a scripted login is failing on SSO, MFA, CAPTCHA or bot detection. Also use for reading a page's real rendered CSS, capturing a full page, inspecting React state, or recording and replaying a UI flow against a live session.