安装指南

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

什么是

Oya Browser 通过 Oya Cloud 和受支持的浏览器提供商，将 AI 代理连接到真实的 Chrome 浏览器。每个浏览器都以持久化身份运行，具有一致的指纹、Cookie 和 proxy，帮助网站在不同会话中识别同一设备。代理会将页面检查为带编号元素的 Markdown，然后进行点击、输入、导航和验证结果，无需依赖脆弱的选择器。
作为实用的网页自动化 Openclaw Skills 之一，Oya 可通过 MCP 工具、oya CLI 或 @oya-ai/browser SDK 支持工作流。它可以处理表单、浏览、数据提取、CAPTCHA 和 MFA；当网站要求批准或需要关注凭据时，也允许人工接管。

应用场景

浏览网站、打开链接并总结页面内容。
填写并提交网页表单，然后检查页面以确认结果。
使用为某个身份存储的凭据和身份验证因素登录门户网站。
收集结构化页面数据，例如表格行或产品价格。
使用已保存的操作流程自动执行可重复的浏览器工作流。
运行多个浏览器会话，或将会话交由人工批准。
解决 CAPTCHA 并支持 MFA 流程，包括由人工批准推送或通行密钥挑战。

工作原理

配置 Oya API 密钥，并通过 MCP、CLI 或 JavaScript SDK 连接。
使用选定的身份启动浏览器，并在需要时指定提供商或目标 URL。
导航到目标页面并进行分析，以获取页面 Markdown、可见内容和带编号的交互元素。
使用点击、输入、键盘、滚动或其他浏览器控件操作当前元素 ID；必要时使用屏幕截图和坐标。
页面发生变化后重新分析，因为元素 ID 会重新分配，并验证每项操作是否达到预期结果。
通过已存储的身份凭据、CAPTCHA 和 MFA 工具，或在必要时由人工接管，处理身份验证和中断情况。
任务完成后停止浏览器，以释放会话并避免持续产生浏览器费用。

配置指南

在 Oya Browser 控制面板中创建 API 密钥。切勿编造或泄露用户的密钥。
在环境中设置密钥；CLI 和 SDK 会读取 OYA_API_KEY。
选择集成方式。建议代理使用 MCP；CLI 和 SDK 是替代方案。
export OYA_API_KEY="your_api_key"

可选：将 Oya MCP 添加到 Claude

claude mcp add --transport http oya https://oyabrowser.com/mcp/pool --header "Authorization: Bearer $OYA_API_KEY"

可选：安装 CLI

npm install -g @oya-ai/cli

可选：在项目中安装 JavaScript SDK

npm install @oya-ai/browser
使用 CLI 时，请先初始化模型配置，再使用 oya ask。使用 oya start --persona auto 启动浏览器，使用 oya goto 导航，并使用 oya rm 或 oya rm --all 停止浏览器。在代码中，实例化 Oya、启动浏览器、执行任务，并在 finally 块中停止浏览器。Openclaw Skills 用户应选择其代理环境中可用的接口。

数据架构

Oya 围绕身份组织浏览器状态，而不是使用一次性的页面会话。身份会在多次运行之间保留设备指纹、Cookie jar、proxy 和登录状态；凭据与身份验证因素按网站分别存储。
数据或输出 组织方式和行为
身份 持久化浏览器身份；auto 会在并发上限内选择最近最少使用的身份，而 default 使用密钥的默认身份。
页面分析 包括 URL、标题、视口和滚动详情、Markdown 内容，以及已编入索引的可见和屏幕外元素。每次分析后元素 ID 都会改变。
浏览器会话 正在运行的浏览器具有 ID，可供检查、控制、交由人工操作、恢复或停止。
提取的数据 run_script 可读取表格行或列出的价格等页面数据；它是只读的，因此交互需使用浏览器操作。
操作流程和任务报告 可列出并使用变量重放已保存的流程；run_task 会将任务委派给 Oya 的代理并返回报告。
身份验证状态 网站凭据和身份验证因素属于某个身份。MFA 可使用密封的 TOTP 种子，或已配置的 Gmail 或 Microsoft 365 邮箱；某些批准操作需要人工通过实时查看 URL 完成。
技能文档介绍了浏览器和身份状态，但未指定本地生成文件的布局。

高级特性

多种接口：
通过 Oya MCP 工具、
oya
CLI 或
@oya-ai/browser
SDK 控制浏览器。
持久化身份：
重复使用一致的指纹、Cookie、proxy 和网站登录状态；需要另一种设备身份时，可克隆身份。
感知页面的自动化：
分析带编号元素的 Markdown，使用
find
搜索元素，并使用
wait_for
等待文本、URL 或网络活动。
扩展的浏览器控件：
使用屏幕截图、坐标点击、悬停、拖动、原生下拉选项、键盘输入、导航历史记录、重新加载和对话框处理。
无需反复与模型交互的自动化：
使用变量重放命名的操作流程，或通过
run_task
委派整个任务。
CAPTCHA 和 MFA 支持：
解决 CAPTCHA、输入受支持的 MFA 验证码，并在人需要批准挑战时提供实时查看 URL。
人工接管：
使用 CLI 接管，让人工在实时浏览器中操作，然后释放并恢复会话。
Playwright 和 Puppeteer 兼容性：
通过 Chrome DevTools Protocol 使用 SDK 的
browser.cdpUrl
连接。
操作保障措施：
页面发生变化后重新分析，完成后停止浏览器；不要在并发限制时循环重试，也不要重试被拒绝的密码。

name: oya-browser homepage: https://oyabrowser.com
description: Drive real Chrome browsers through Oya Browser. Start a browser on Oya Cloud, Browserbase, Steel, Anchor or Browser Use under a persistent persona, read pages as markdown with numbered elements, click and type, solve CAPTCHAs and MFA, and hand off to a human when needed. Use when the user asks to browse a site, automate a web task, fill a form, log in somewhere, scrape, or run several browsers at once. Works through the Oya MCP tools (start_browser, analyze_page, click, type…), the oya CLI, or the @oya-ai/browser SDK.