open-connector

官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

OpenConnector 是面向 AI Agent 的开源 connector gateway，也是 Pipedream/Composio 的开源替代方案。 连接一次用户应用账号，就可以把包含 1,000+ 个 provider 和 10,000+ 个预置 Action 的共享 catalog 暴露给 Agent 和应用。

应用代码使用 Connector SDK，本地 Agent 使用 oo CLI 中继，Agent host 使用 MCP，自定义客户端使用 HTTP/OpenAPI；管理和调试使用本地 Web 控制台。

• 把 credential、scope、schema、policy 和运行日志保留在可检查的 runtime 里。
• 支持本地运行、自有基础设施部署，也可以使用 OOMOL 托管 runtime。
• 开源版和商业 SaaS 版共享同一套 provider id、Action id、schema 和契约。

提供什么

• 一套可直接使用的 connector catalog，覆盖 GitHub、Gmail、Notion、BigQuery、Google Analytics、Supabase、Airtable、Slack 等常见产品。
• 支持 API key、OAuth2、自定义凭据，以及无需鉴权的 provider。
• 可以审查和扩展的 Action 契约：请求/响应 schema、required scope 和按需加载的 executor 源码。
• 面向生产的 runtime 控制：connection identity、scope、runtime token、action allow/block policy、临时文件中转和脱敏运行日志。
• 部署方式覆盖本地 Docker 或 Node.js，以及 OOMOL 托管 runtime。其他托管平台见 部署方案。

适合什么场景

OpenConnector 适合需要让 Agent 持续访问用户现有工具、但不想把 provider credential 交给 Agent 进程的产品。

• 需要在工作应用、开发者工具、数据系统、沟通平台和 AI 服务之间复用接入层的 Agent 产品。
• 正在加入 Agent workflow，并希望通过稳定、可审查的 Action 契约接入用户应用的产品。
• 希望先用托管鉴权快速上线，同时保留未来私有化或自托管 runtime 控制权的团队。

开发者工具

Endpoint、response envelope、鉴权 header、MCP tools 和 Action guide 示例见 runtime-api.md。

Dashboard 预览

OpenConnector 内置本地 Dashboard，可用于浏览 connector、配置 credential、创建 runtime token 和查看运行时使用数据。

Connector 预览

通过 connector catalog 可以查看可用服务、搜索 provider，并进入对应的 Action 与 credential 配置。

数据统计概览

部署后，Overview 页面会集中展示运行时状态、可用 provider、可执行 Action、最近失败、工具调用趋势和最近调用记录。

Provider 名称和商标归各自权利人所有，本项目仅用于识别服务和实现互操作。

工作方式

flowchart LR
  Agent["AI Agent / App"] -->|"SDK / CLI / MCP / HTTP"| Gateway["OpenConnector Gateway"]
  Gateway --> Auth["Credential & OAuth Boundary"]
  Gateway --> Catalog["Provider Catalog"]
  Gateway --> Actions["Open-source Action Executors"]
  Gateway --> Policy["Tokens, Scopes, Allow/Block Policy"]
  Gateway --> Logs["Run Logs"]
  Actions --> Providers["1,000+ Providers"]
  Console["Web Console"] --> Gateway
  Cloudflare["Cloudflare Workers, D1, R2"] -. deploy .-> Gateway

应用或 Agent 可以发现 Action、查看 schema 和 scope、选择 connection alias，并通过网关执行调用。Provider secret 保留在运行时边界内；Agent 拿到本次运行所需的 metadata、安全账号标签和执行结果。

使用路径

快速开始

使用 Docker Compose 从发布的镜像启动运行时：

docker compose up

这会拉取 ghcr.io/oomol-lab/open-connector:latest。想改为从源码构建：

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":{}}'

完整本地启动、第一个 provider 连接、OAuth flow 和运行时设置见 quickstart.md。

连接 Provider

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_..."}}'

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

OAuth2 应用、命名连接、凭据加密、token 刷新和 action policy 见 credentials.md 与 configuration.md。

Web 控制台

启动运行时后打开 http://localhost:3000。控制台支持浏览 provider、保存 API key 或 OAuth client 配置、创建 runtime token、查看 Action schema、调试 Action、查看最近运行记录，并打开生成的 OpenAPI 和 MCP metadata。

Docker 镜像（GHCR）

可以直接用 GitHub Packages（GHCR）上的预构建镜像运行 OpenConnector：ghcr.io/oomol-lab/open-connector。最新 release 用 latest，生产环境固定具体的 release 版本号，想用最新 main 构建则用 tip。

镜像标签、拉取和运行的说明见 docker-ghcr.zh-CN.md。

开箱即用的 AI Bot：Leina

如果想使用开箱即用的 AI Bot，可以试试 Leina。Leina 可连接 1500 多款 SaaS 应用，让你自由组合应用连接、技能和知识库，定制适合团队工作流程的 AI Agent。

它支持 Slack、Microsoft Teams、Discord、Telegram，以及钉钉、企业微信、飞书和个人微信。你可以直接在聊天中，让它通过你授权的应用查找信息、汇总周报、整理客户反馈或准备销售跟进内容。

文档

• 快速开始
• 开发者工具
• 客户端接入：MCP、CLI 和 SDK
• Gmail OAuth 和 SDK 接入教程
• Runtime API 和 MCP
• 部署方案
• Fly.io 部署
• Cloudflare 部署
• Docker 镜像（GHCR）
• 配置项
• 凭据和 OAuth
• Catalog 格式
• Verification 语言
• 贡献指南
• 行为准则
• 安全政策

开发

请使用 Node.js 22 或更新版本：

npm install
npm run dev

本地 API runtime 监听 http://localhost:3000。Web Console 开发服务器监听 http://localhost:5173，并把 API 请求代理到 runtime。

打开 pull request 前运行：

npm run fix-check
npm test

Provider 代码位于 src/providers/<service>。Provider 贡献规则见 CONTRIBUTING.md。

许可证范围

除非另有说明，本仓库中的源代码、脚本、生成的项目脚手架、测试和文档均基于 Apache License, Version 2.0 授权。见 LICENSE.txt。

本仓库的 Apache-2.0 许可证不授予任何第三方产品、provider、app、API、商标、服务标识、商号、logo、 icon、品牌资产、文档、截图或其它归属于相应权利人的版权材料的使用权。

Provider 和 app 名称、metadata、链接、scope、permission 以及可选 logo/icon 仅用于识别服务和实现互操作。 所有第三方品牌和产品权利仍归各自权利人所有。本 catalog 中出现某个服务不代表其权利人对本项目的认可、赞助、合作、认证或验证。

如果你贡献 provider metadata 或资产，请只提交你有权提交的材料。优先链接到官方公开资产，而不是把品牌文件复制到本仓库。

社区

请让 issue 和 pull request 保持聚焦、尊重且可执行。参与本项目需遵守 CODE_OF_CONDUCT.md。

支持 OpenConnector

如果 OpenConnector 对你有帮助，点个 ⭐ 可以帮助更多开发者发现这个项目。

Star 历史