OpenConnector

这个 Agent 能做什么，适合哪些场景？

OpenConnector 是一个面向 AI 应用的开源连接器网关，用于连接用户已授权的 SaaS 账户与可执行操作。它提供包含 1,000 多个服务商和 10,000 多个预构建 Action 的目录，并支持 API Key、OAuth2、自定义凭据和免认证服务。应用或代理可通过 Connector SDK、oo CLI、MCP、HTTP API 或生成的 OpenAPI 文档发现和调用 Action。网关在运行时处理连接别名、作用域、运行时令牌、Action 允许/阻止策略、临时文件传递与脱敏运行日志，避免将服务商密钥直接交给代理进程。它可本地以 Docker 或 Node.js 运行，也可部署到 Fly.io、Cloudflare Workers/D1/R2，或使用 OOMOL 托管运行时。

客户端先浏览服务商目录，读取 Action 的请求/响应 schema、所需 scopes 与执行器信息；随后选择连接别名并通过网关执行。自托管实例可用 PUT /api/connections/github 写入 GitHub 凭据，再以 POST /v1/actions/github.get_current_user 调用 Action；免认证验证可调用 POST /v1/actions/hackernews.get_top_stories。MCP 客户端可连接 http://localhost:3000/mcp，HTTP 客户端可调用 /v1/actions/*，并从 /openapi.json 获取接口描述。Web Console 用于浏览连接器、配置凭据、创建 runtime token、检查 schema、调试 Action 和查看近期运行记录。

1. 正在构建企业助手的开发团队，需要让助手在用户授权后操作 GitHub、Gmail、Notion、Slack 或 Airtable，而不把凭据注入助手进程。
2. 为现有 AI 产品增加工具调用的工程师，需要通过 HTTP 或 OpenAPI 调用统一的 SaaS Action 接口。
3. 使用 MCP 主机的本地开发者，需要从 http://localhost:3000/mcp 向主机暴露已连接应用的 Action。
4. 希望在自身 Cloudflare 账户运行连接器服务的团队，需要使用 Workers、D1、R2 和静态控制台部署运行时。
5. 需要排查授权、作用域或 Action 调用问题的运维人员，需要在 Web Console 中查看 Action schema、调试调用和脱敏运行日志。

如何安装或部署这个 Agent？

本地自托管可直接运行：

docker compose up

该命令拉取 ghcr.io/oomol-lab/open-connector:latest。若要从源码构建：

docker compose -f docker-compose.yml -f docker-compose.build.yml up --build

运行后控制台位于 http://localhost:3000，API 文档位于 http://localhost:3000/docs。开发源码需要 Node.js 22 或更高版本，并执行 npm install 和 npm run dev。OAuth 服务商需要自行在相应服务商处注册并配置 OAuth 客户端凭据；GitHub 示例可使用个人访问令牌。

如何使用这个 Agent？

先验证运行时：

curl -s -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

配置 GitHub 后调用当前用户：

curl -s -X PUT http://localhost:3000/api/connections/github \
  -H 'content-type: application/json' \
  -d '{"authType":"api_key","values":{"apiKey":"github_pat_..."}}'

curl -s -X POST http://localhost:3000/v1/actions/github.get_current_user \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

也可使用 Connector SDK、oo connector、MCP 端点或 /v1/actions/* HTTP 接口；通过 /openapi.json 检查生成的 OpenAPI 描述。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v1.9.9 2026-11-05
   发布说明摘录

   What's Changed * feat(oomol-rag): add atomic block-level article editing by @alwaysmavs in https://github.com/oomol-lab/open-connector/pull/844 Full Changelog: https://github.com/oomol-lab/open-connector/compare/v1.9.8...v1.9.9

   在 GitHub 查看 ↗
2. v1.9.8 2026-11-05
   发布说明摘录

   What's Changed * feat(oomol-rag): accept Markdown for article creation and updates by @alwaysmavs in https://github.com/oomol-lab/open-connector/pull/843 Full Changelog: https://github.com/oomol-lab/open-connector/compare/v1.9.7...v1.9.8

   在 GitHub 查看 ↗
3. v1.9.7 2026-11-05
   发布说明摘录

   What's Changed * fix(oomol-rag): preserve gateway rejection status by @alwaysmavs in https://github.com/oomol-lab/open-connector/pull/842 Full Changelog: https://github.com/oomol-lab/open-connector/compare/v1.9.6...v1.9.7

   在 GitHub 查看 ↗

常见问题