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 把”配置噩梦”变成了一句话的事。
评论区
登录后可评论。