跳至正文

快速开始

运行 OpenConnector,调用第一个 Action

选择本地运行以掌控配置,或通过 OOMOL 省去部署。两条路径都能带你开始调用真实 Action。

01 / 你的基础设施

运行本地 OpenConnector。

需要 Git 和包含 Docker Compose 的 Docker 环境。先调用无需授权的 Action,再配置应用账户。

  1. 1. 启动运行环境

    克隆仓库并启动已发布的镜像。此体验流程用于你自己机器上的本地环境。

    Terminal
    git clone https://github.com/oomol-lab/open-connector.git
    cd open-connector
    docker compose up
  2. 2. 调用第一个 Action

    在另一个终端获取 Hacker News 热门文章。此只读 Action 无需服务账户授权。

    HTTP · Hacker News
    curl -s -X POST \
      http://localhost:3000/v1/actions/hackernews.get_top_stories \
      -H 'content-type: application/json' \
      -d '{"input":{}}'
  3. 3. 连接应用账户

    打开本地控制台,选择服务并配置凭证。OAuth 服务需要你在对应平台上注册自己的 OAuth 应用。

    凭证与 OAuth
OpenConnector 运行概览,展示就绪状态、Action 活动与最近运行记录
截图来自开源项目仓库,目录数量对应截图中的版本。

公开部署前,需要配置管理端认证、运行时令牌、凭证加密和 OAuth 公网地址。生产环境设置请遵循部署指南。

完整部署指南

02 / 免部署开始

通过 OOMOL 连接。

使用托管运行环境与支持应用的托管 OAuth,选择适合你的连接调用方式。

  1. 01

    连接你的应用

    登录 OOMOL,选择应用并授权要使用的账户。部分应用需要 API Key 或自定义凭证。

  2. 02

    选择客户端

    通过 Agent 安装指南配置 CLI 或 MCP。后端代码可以创建个人 API Key,并使用 Connector SDK 客户端。

  3. 03

    完成首次调用

    从一个简单的只读 Action 开始,调用前确认使用的连接和权限。