OpenConnector：AI Agent 连接器网关

项目简介

OpenConnector 是一个面向 AI Agent 的开源连接器网关，可作为 Pipedream / Composio 的替代方案。用户只需连接一次应用账号，就能以统一的提供商目录（1,000+ providers、10,000+ 预置 Action）向 Agent 和应用程序开放能力。它把凭证、scope、schema、策略和运行日志收在可检查的运行时边界内，Agent 进程拿不到提供商的密钥。

主要功能

• 覆盖 GitHub、Gmail、Notion、BigQuery、Google Analytics、Supabase、Airtable、Slack 等产品的连接器目录。
• 凭证处理支持 API Key、OAuth2、自定义凭证与免认证提供商。
• 内置 OAuth 2.1 授权服务器，支持动态注册客户端、PKCE S256，以及可撤销、受策略约束的访问令牌。
• 可检查的 Action 契约：请求/响应 schema、所需 scope、懒加载的执行器源码。
• 运行时控制：连接身份、scope、runtime token、Action 允许/阻止策略、临时文件中转、脱敏运行日志。
• 部署方式：本地 Docker 或 Node.js（SQLite 或 PostgreSQL 存储，本地或 S3 兼容中转存储），另有 OOMOL 托管运行时与 Helm Chart 等方案。

接入方式

• Connector SDK：轻量 TypeScript HTTP 客户端。
• oo CLI：本地 Agent 中继，oo connector 可搜索、检查并运行 Action。
• MCP：通过 http://localhost:3000/mcp 向支持 MCP 的 Agent 宿主暴露应用 Action。
• HTTP / OpenAPI：直接调用 /v1/actions/*，或查看生成的 /openapi.json。

安装与使用

用 Docker Compose 启动自托管运行时：

docker compose up

从源码构建则使用：

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

启动后打开控制台与 API 文档：

http://localhost:3000
http://localhost:3000/docs

调用一个免认证 Action 验证运行时：

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

连接 GitHub 这类凭证型提供商（使用 personal access token）：

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

也支持 GitHub App 安装方式：保存 App ID、installation id 和私钥，运行时按需换取一小时安装令牌。

自带的 Dashboard 可用于浏览连接器、配置凭证、创建 runtime token 和查看运行时用量。

注意事项

• 自托管运行时中，OAuth 提供商需要你自己在对应平台注册应用并配置 OAuth 客户端凭证；若想让用户直接授权，可使用 OOMOL 托管连接器。
• 自托管模式下的存储与 OAuth 应用由你自己管理。
• 提供商名称与商标归各自所有者，仅用于标识与互操作。

---

本作品整理自 GitHub 开源项目 oomol-lab/open-connector，原作者 @oomol-lab。中文介绍由 AI 根据项目 README 整理，以原仓库为准。