帮助中心

Omnibot 是一个本地 CLI 浏览器自动化系统，通过常驻守护进程和配套的 Chromium 扩展，将真实浏览器的能力暴露给 AI Agent，取代了之前的 MCP 工具工作流。

核心组件

CLI — 浏览器操作的命令行工具
守护进程 — 持久的后台服务
浏览器扩展 — 连接到真实浏览器标签页
Agent 技能 — 各种 AI Agent 的配置

安装 CLI

通过 npm 全局安装 Omnibot CLI（推荐）：

npm install -g @omniaibot/omnibot

自动检测平台并安装对应的二进制文件。

安装后运行 omnibot doctor 验证安装。

加载浏览器扩展

打开 Chrome Web Store 中的 Omnibot 扩展页面
点击「添加至 Chrome」并完成安装
安装后点击浏览器右上角的 Omnibot 扩展图标
确认扩展显示已连接，或复制弹窗中的机器码用于购买激活码

Chrome Web Store 地址：https://chromewebstore.google.com/detail/fojlpefamkmjbboafmjkkaejohagbdgn

默认情况下，扩展会连接本地 WebSocket 服务 127.0.0.1:18765。

扩展弹窗配置：

WebSocket 地址：ws://127.0.0.1:18765
连接状态会自动刷新
如果连接失败，先运行 omnibot doctor 检查守护进程状态

检查连接

不需要手动启动守护进程。直接运行任意浏览器命令时，omnibot CLI 会自动启动本地守护进程，浏览器扩展会通过 WebSocket 连接到 127.0.0.1:18765。

omnibot doctor
omnibot tabs

doctor 检查守护进程和扩展状态。tabs 列出可用的浏览器标签页。

如果 doctor 显示扩展未连接，请打开 Chrome/Edge，加载或重新加载浏览器扩展，并保持至少一个 HTTP/HTTPS 标签页打开。

安装 Agent 技能

Omnibot v2 通过技能替代 MCP 提示词注入：

omnibot skills install --agent hermes --profile nuwa
omnibot skills install --agent opencode
omnibot skills install --agent claude
omnibot skills install --agent codex

查看内置技能路径：

omnibot skills path

Omnibot 内置了流行 AI Agent 的技能配置。从快速开始页面选择你的 Agent 即可获取安装命令。

配置智能体

安装技能后，配置你的 AI Agent 使用 Omnibot。每个 Agent 都有自己的配置方法 — 详情见快速开始页面。

OpenCode 配置：

配置文件位置：~/.config/opencode/opencode.json

{
  "mcp": {
    "omnibot": {
      "type": "local",
      "command": ["npx", "omnibot"],
      "enabled": true
    }
  }
}

Claude Code 配置：

claude mcp add omnibot -- npx omnibot

Codex 配置：

{
  "mcp_servers": {
    "omnibot": {
      "command": ["npx", "omnibot"],
      "enabled": true
    }
  }
}

Hermes 配置：

hermes mcp add omnibot -- npx omnibot

命令参考

Omnibot v2 提供以下主要命令：

命令	说明
`omnibot doctor`	检查守护进程与扩展连接状态
`omnibot tabs`	获取已连接标签页列表
`omnibot snapshot`	获取可交互快照
`omnibot read`	滚动长页面后扫描，适合只读总结
`omnibot find`	查找并与元素交互
`omnibot navigate`	导航到指定 URL
`omnibot screenshot`	截图并返回路径或 base64
`omnibot execute-js`	在当前标签页执行 JavaScript
`omnibot batch`	批量执行扩展/CDP 命令
`omnibot wait`	轮询 JavaScript 条件直到返回真值或超时
`omnibot session list`	列出所有会话
`omnibot license status`	查看许可证状态

激活流程

在价格页面购买激活码
从确认页面或邮件中复制激活码
点击 Chrome 中的 Omnibot 扩展图标
在弹窗中粘贴激活码
点击「激活」

每台设备需要自己的激活码。

故障排除

常见问题：

扩展无法连接

确保扩展已安装并启用
检查至少有一个 HTTP/HTTPS 标签页是打开的
运行 omnibot doctor 诊断

命令不工作

验证守护进程正在运行：omnibot doctor
检查标签页可用性：omnibot tabs
确保许可证已激活

常见问题

Q：Omnibot 支持哪些浏览器？

A：Omnibot 支持基于 Chromium 内核的浏览器（Chrome、Edge、Brave 等）。

Q：我的数据安全吗？

A：安全。Omnibot 在本地运行，从不将浏览器数据发送到外部服务器。

Q：我可以在多台设备上使用 Omnibot 吗？

A：每台设备需要自己的激活码。你可以一次性购买多个激活码。

Q：支持哪些 AI Agent？

A：OpenCode、Claude Code、Codex、Hermes、Trae 等。完整列表见快速开始页面。

Windows 常见问题

Q：PowerShell 提示「无法加载，因为在此系统上禁止运行脚本」？

A：这是 PowerShell 执行策略阻止脚本执行导致的。

原因：

Windows 上的 npm 全局包会创建两个文件：

omnibot.cmd — 用于 cmd.exe
omnibot.ps1 — 用于 PowerShell

在 PowerShell 中运行 omnibot 时，系统优先尝试执行 .ps1 脚本，但 PowerShell 默认阻止脚本：

Get-ExecutionPolicy -Scope CurrentUser
# 输出: Restricted

解决方案：

在 PowerShell 中运行以下命令（只需执行一次）：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

之后，PowerShell 中直接运行 omnibot 即可正常使用。

Q：其他 npm 全局工具在 PowerShell 中也无法运行？

A：同样的执行策略问题。使用上述解决方案即可。这适用于 Windows 上所有 npm 安装的 CLI 工具。

macOS / Linux 常见问题

暂无特定问题。如遇到问题，请在社区反馈。