API Gateway Skill:一键让 AI Agent 直连 100+ 第三方 API 的安全接入层

API Gateway Skill:一个 MATON_API_KEY 让 AI Agent 原生直连 100+ 第三方 API

在 AI Agent 越来越深入业务工作流的当下,一个核心瓶颈正在显现:每接一个第三方服务,都要折腾 OAuth 实现、凭据管理和 API 调试。GitHub 要配 token,Slack 要建 App,HubSpot 要拿 Client ID——同一个 AI 助手想联动四五个平台,光配置就能把人劝退。

byungkyu 开发的 API Gateway Skill 就是来解决这个问题的。它通过 Maton.ai 的统一网关,让 AI Agent 只需一个 MATON_API_KEY,就能原生调用 Google Workspace、GitHub、Slack、HubSpot 等 100+ 服务的 REST API 端点,所有 OAuth 流程由网关代管,用户点一次授权即可,Agent 无需接触任何第三方凭据。

功能与原则

核心能力:统一路由层——把不同平台的 API 封装成一致的调用格式,Agent 只需调用 maton connection create <app> 完成 OAuth 授权,之后所有 API 请求都通过 maton CLI 代理完成。

设计原则:
– 零摩擦授权:OAuth 流程由 Maton 代管,Agent 收到授权链接后转给用户,用户确认即完成
– 最小权限原则:每个连接独立授权,Agent 只能访问用户明确授权的范围
– 凭据不落地:长期凭据存在 Maton 云端,本地只有短期 access token,自动刷新,Agent 进程本身看不到密钥
– 平台无关:只要能跑命令行的 Agent(Claude Code、OpenClaw、Cursor 等)都能用

认可度

  • ClawhHub 下载量:394 次(截至 2026-10-06,ClawhHub 平台数据)
  • ClawhHub 评分:B 级(安全评级),质量 8.5/10
  • 平台支持:ClawhHub 官方收录,最新版本 v1.0.85(2026 年 10 月更新)
  • 定位:中型 Skill,适合需要跨平台业务自动化的中高级用户

链接

GitHub(SKILL.md 源码在 openclaw/skills 仓库):https://github.com/openclaw/skills

ClawhHub 主页:https://clawhub.ai/byungkyu/skills/api-gateway

原作者

byungkyu(@byungkyu),OpenClaw / ClawhHub 生态活跃贡献者,专注于 API 集成与 Agent 工具层基础设施。

介绍

API Gateway 本质上是一个统一 API 接入层,而不是又一个 API 封装库。它不重新实现 GitHub API 或 Slack API 的语义——它只是让 Agent 在调用这些 API 时,不需要自己去处理 OAuth 2.0 的 Authorization Code 流程、token 刷新、scope 协商这些繁琐事务。

典型使用场景:用户对 Agent 说”帮我给这个 GitHub Issue 加个标签”,Agent 内部调用 gh issue add-labels 或直接调 GitHub REST API,但没有 OAuth token 的话会被 401。如果用户已提前授权了 GitHub 连接,Agent 只需通过 Maton 路由请求,Authorization 头由网关自动注入。

安装后,Agent 通过 /api-gateway list 可以查看所有已接入平台和当前连接状态;通过 /api-gateway auth <app> 可以触发新平台授权流程。

特点

  • 100+ 服务支持:覆盖通讯协作(Slack、Discord、Teams)、CRM(HubSpot、Salesforce、Pipedrive)、项目管理(Notion、Linear、Jira、Asana)、云存储(Google Drive、Dropbox、OneDrive)、开发工具(GitHub、GitLab、Vercel)、日历、电商支付等主流平台
  • 托管 OAuth:所有第三方 OAuth 由 Maton.ai 代管,用户点授权链接即可,Agent 永远不接触长期凭据
  • 统一认证入口:用户只需一个 MATON_API_KEY(向 Maton 注册获取),即可连接任意数量的服务
  • 安全隔离:Maton API Key 本身不授予任何第三方服务访问权限,必须经用户显式授权;授权信息加密存储在 Maton 云端
  • 无锁平台:不依赖特定 AI Agent 实现,任何支持 shell 命令执行的 Agent 都能接入,包括 Claude Code、OpenClaw、Cursor、Windsurf 等

使用方法

安装:

# 通过 ClawhHub CLI(一键安装)
npx clawhub@latest install api-gateway

# 或通过 OpenClaw CLI
openclaw skills install @byungkyu/api-gateway

# 或通过 skills.sh
npx skills add @byungkyu/api-gateway

Maton CLI 安装(必需依赖):

# via npm
npm install -g @maton/cli

# via Homebrew
brew install maton-ai/cli/maton
brew pin maton

授权第一个平台(以 Slack 为例):

/api-gateway auth slack

Agent 返回授权链接,用户在浏览器中打开并确认授权,之后 Maton 自动完成 OAuth 流程并通知 Agent 连接已激活。

基本调用示例:

# 列出所有连接状态
maton connection list --status ACTIVE

# 在 Slack 频道发消息
maton call slack chat.postMessage '{"channel": "#general", "text": "Deploy 完成!"}'

使用场景与人群

适用场景:
– 需要跨平台操作的工作流自动化(发 Slack 消息 + 更新 Notion + 写 GitHub Issue)
– AI Agent 直接操控企业级 SaaS 工具(CRM、日历、邮件)
– DevOps 自动化场景(触发 GitHub Actions、Netlify 部署、Sentry 报警)
– 研究助手类 Agent 读取外部数据(B站视频字幕、LinkedIn 页面、RSS 源)

目标用户:
– 需要 AI Agent 接入企业工具链的开发者
– 构建跨平台自动化工作流的个人用户
– 在 OpenClaw / Claude Code 环境中需要整合多个 SaaS 服务的用户

输入与输出案例

案例 1:Slack 消息通知

输入(用户对 Agent 说):

帮我把刚完成的测试报告发到 #qa-team 频道,告诉他们所有用例都通过了。

Agent 内部流程:

# Agent 检查连接状态
maton connection list slack --status ACTIVE
# → {"connections": [{"connection_id": "xxx", "status": "ACTIVE", ...}]}

# 直接发消息
maton call slack chat.postMessage '{"channel": "#qa-team", "text": "✅ 所有测试用例通过,报告已生成。"}'

输出:Slack 频道 #qa-team 收到消息”✅ 所有测试用例通过,报告已生成。”


案例 2:GitHub Issue 创建与标签

输入(用户对 Agent 说):

在 cloudflare/cloudflare-os 仓库里新建一个 Issue,标题是”OpenShell 和 WasmEdge 集成问题”,标签是 bug,然后给它加上 “priority/high” 标签。

Agent 内部流程:

# 检查 GitHub 连接
maton connection list github --status ACTIVE
# → 已授权,Agent 有 GitHub 访问权限

# Agent 拼接 GitHub REST API 调用
maton call github POST '/repos/cloudflare/cloudflare-os/issues' 
  '{"title": "OpenShell 和 WasmEdge 集成问题", "labels": ["bug"]}'
# → 返回创建的 Issue 编号

# 再加标签
maton call github POST '/repos/cloudflare/cloudflare-os/issues/42/labels' 
  '["priority/high"]'

输出:GitHub Issue #42 创建成功,带 bug 和 priority/high 两个标签。


安装方式极简,授权一次即可驱动数十个平台——对于需要让 AI 真正深入业务工具链的开发者,这个 Skill 把”配置噩梦”变成了一句话的事。


GitHub: https://clawhub.ai/byungkyu/skills/api-gateway

评论区

0 条评论

登录后可评论。

Skill超级捕获手 10 阅读