捆绑包插件
Oh My Browser — 使用真实浏览器交互的 AI 助手插件
v0.1.6Oh My Browser 插件允许 AI 助手使用您的真实 Chrome 浏览器会话进行网页交互，支持认证访问、多引擎搜索、页面内容提取、浏览器自动化、元素发现和可访问性快照。通过本地 CLI 和 Chrome 扩展实现，需注意安全风险。
0· 6·0 当前0
版本
latestv0.1.62026/4/11
安装命令
点击复制官方npx clawhub@latest install oh-my-browser
镜像加速npx clawhub@latest install oh-my-browser --registry https://cn.clawhub-mirror.com
插件文档
oh-my-browser
让 AI 助手使用 您的真实浏览器 搜索和交互网页 —— 保留登录、cookie 和本地化设置。
功能
- 认证网页访问 —— 助手使用浏览器会话访问登录要求的页面（Gmail、Notion、内部工具等）
- 多引擎搜索 —— 通过 Google、百度、搜狗或浏览器会话进行个性化搜索
- 页面阅读 —— 从任意网页提取清洁内容，支持多格式（markdown、文本、HTML）
- 浏览器自动化 —— 点击、填充、滚动、截屏、执行 JS 等，通过真实 Chrome 实现全面的浏览器交互
- 元素发现 —— 通过标签、类型或区域查找交互元素
- 可访问性快照 —— 为 SPA/动态页面提供稳定的元素引用（@1、@2...）
- 零配置 —— 无需 API 密钥配置。安装、授权即可使用。
工作原理
助手 —> oh-my-browser 插件 —> omb CLI（子进程） —> API —> 您的 Chrome 扩展插件启动 omb CLI 子进程，通过 MCP（stdio JSON-RPC）协议进行通信。所有浏览器操作均通过 Oh My Browser Chrome 扩展在您的真实浏览器中执行。
安装
一键安装（推荐）
# macOS / Linux curl -fsSL https://api.omb.org.cn/install | bash # Windows (PowerShell) irm https://api.omb.org.cn/install | iex安装脚本将指导您完成以下步骤：
- 下载 omb CLI —— 命令行工具
- 登录 —— 在浏览器中授权
- 安装 OpenClaw 插件 —— 自动检测 OpenClaw 实例
- 下载 Chrome 扩展 —— 助手与浏览器的桥梁
或仅安装插件
openclaw plugins install oh-my-browser如果 omb CLI 尚未安装，请运行上述一键安装脚本设置。
登录
如果安装时跳过登录或会话过期：
omb login此操作将在浏览器中打开授权页面。在 OpenClaw 助手会话中，助手将自动指导授权。
然后重启网关：
openclaw gateway restart工具
| 工具 | 描述 |
|---|---|
omb_search | 网页搜索（自动、浏览器会话或指定引擎：google/baidu/sogou） |
omb_read | 读取网页并提取内容（支持认证页面） |
omb_action | 浏览器交互：点击、填充、滚动、截屏、执行 JS 等 |
omb_map | 发现页面交互元素（按标签、类型或区域过滤） |
omb_snapshot | 可访问性快照，提供稳定的元素引用 (@1, @2...) |
omb_guide | 加载每个工具的详细使用指南 |
omb_report | 报告页面提取质量问题 |
使用示例
搜索网页
omb_search({ query: "OpenClaw 插件", max_results: 5 })读取登录要求的页面
omb_read({ url: "https://notion.so/my-private-page" })交互页面
// 1. 读取页面 omb_read({ url: "https://example.com" }) // 2. 发现元素 omb_map({ tabId: 123, label: "Search", types: ["input"] }) // 3. 填充并提交 omb_action({ action: "fill", tabId: 123, selector: "#search-input", value: "hello" }) omb_action({ action: "keypress", tabId: 123, key: "Enter" })截屏
omb_action({ action: "screenshot", tabId: 123, annotate: true })故障排除
| 错误 | 原因 | 解决方案 |
|---|---|---|
Could not find omb binary | omb CLI 未安装 | 运行 curl -fsSL https://api.omb.org.cn/install | bash |
fetch failed | 浏览器未运行或扩展断开连接 | 打开 Chrome，检查扩展显示 "Connected" |
AUTH_SESSION_MISSING | 未授权 | 运行 omb login 授权 |
omb process exited | omb CLI 崩溃 | 检查 ~/.omb/omb 是否存在；必要时重新安装 |
要求
- omb CLI —— 通过上述安装脚本安装
- Chrome 带有 Oh My Browser 扩展，安装并运行
- Node.js 18+ （用于插件运行时）
架构
助手 —> oh-my-browser 插件 —> omb —mcp (子进程) —> API —> Chrome 扩展插件本身不直接调用 API。它启动 omb 子进程，通过 MCP（stdio JSON-RPC）协议转发所有工具调用。
许可
MIT