SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场opendia-harness

opendia-harness

智能体与模型

查看项目

更新于 10-15 10:09

技能介绍

用途

OpenDia harness 是一份面向 Grok Build（以及其他 MCP 宿主）的 OpenDia 安装、配置与故障排查指南。它帮助用户把 OpenDia 插件接入宿主环境，让 AI 客户端能够通过 MCP 控制浏览器扩展，并在出现连接或工具调用问题时定位原因。

主要能力

  • 插件安装：通过 grok plugin marketplace 添加并安装 opendia 插件，或指定仓库内路径进行安装。
  • 手动配置：提供 config.toml 中 [mcp_servers.opendia] 的完整条目示例，包括 command、args、enabled、startup_timeout_sec。
  • 端口配置：支持自定义 WebSocket 与 HTTP 端口，并强调必须与扩展期望的端口一致。
  • 扩展检查清单：从 GitHub Releases 安装 Chrome 或 Firefox 扩展，按 README 加载，并确认弹出窗口显示已连接到 ws://localhost:5555（或所选 WS 端口）。
  • 诊断命令：grok mcp list、grok mcp doctor opendia、grok plugin details opendia。
  • 常见故障对照：列出症状、可能原因与修复方法。
  • 运行模式说明：本地（默认）、--tunnel、--http-host=0.0.0.0。

使用方式

安装插件：

grok plugin marketplace add aeonfun/opendia grok plugin install opendia --trust

或固定路径：

grok plugin install aeonfun/opendia#plugins/opendia --trust

启用插件（/plugins 或 [plugins].enabled）。MCP 服务器挂载需要信任。

手动 config.toml：

[mcp_servers.opendia] command = "npx" args = ["-y", "opendia"] enabled = true startup_timeout_sec = 60

可选自定义端口（必须与扩展期望一致）：

npx opendia --ws-port=5555 --http-port=5556

默认端口：WebSocket 5555（扩展）、HTTP/SSE 5556、stdio 供 AI 客户端使用。

扩展检查清单：

  1. 从 GitHub Releases 安装（Chrome zip 或 Firefox zip）。
  2. 按主 README 文档加载解压扩展 / 临时附加组件。
  3. 打开扩展弹出窗口——必须显示 Connected to ws://localhost:5555（或你选择的 WS 端口）。
  4. 如果断开：启动或重启 npx opendia，然后重新加载扩展。

诊断命令（Grok Build）：

grok mcp list grok mcp doctor opendia grok plugin details opendia

常见故障：

  • MCP 工具超时：扩展未连接。修复：连接扩展；确认 WS 端口。
  • 工具存在但操作无效：套接字过期 / 服务器重启。修复：重启 npx opendia，重新加载扩展。
  • 仅冷 schema：扩展尚未注册。修复：等待连接 + tools/list_changed，重新列出。
  • 端口冲突：5555/5556 被其他进程占用。修复：npx opendia --port=6000 并将扩展指向新的 WS。
  • npx 缓慢 / 启动失败：npm 冷下载。修复：提高 startup_timeout_sec；首次安装确保网络可用。
  • 隧道 401：缺少 bearer token。修复：传递 Authorization: Bearer <token>（启动时打印）。

运行模式：

  • 本地（默认）——stdio + 回环 WS/SSE。适用于 Grok Build、Claude Code、Cursor。
  • --tunnel——ngrok 公网 URL，用于 ChatGPT 风格的远程连接器。需要 token。不是本地宿主的默认模式。
  • --http-host=0.0.0.0——局域网绑定；同样需要 token。除非有意为之，否则避免使用。

适用场景

  • 在 Grok Build 中安装并启用 OpenDia 插件。
  • 手动配置 MCP 服务器条目与端口。
  • 排查扩展连接、工具超时、端口冲突、隧道鉴权等问题。
  • 在本地宿主（Grok Build、Claude Code、Cursor）中运行 OpenDia。

限制

  • 需要完全隔离 / 无头 CI 浏览器时，应改用云端或基于 CDP 的 MCP，而非 OpenDia。
  • 用户尚未安装扩展时，应引导安装，不能假装浏览器控制可用。
  • 隧道模式与局域网绑定需要 token，且不是本地宿主的默认模式。
  • 相关技能 opendia 提供 harness 健康后的页面分析 → 操作 → 验证运行时手册。