前言¶
给 Agent 接 Slack、Gmail、Stripe 这类第三方 API，常见做法是自己在项目里堆 OAuth、存 refresh token、再写一层 HTTP 封装。账户一多、权限一细，Agent 还容易在没确认的情况下发消息或改数据。下面介绍 SkillHub 上的 API Gateway（坐标 @clawhub_byungkyu/api-gateway），它把「连哪个应用、用哪条连接、做什么读写」写成可复用的 Skill 工作流，底层走 Maton 托管的 API 网关注入凭证，并内置连接管理、触发器、事件重放与用户审批约束。
这是什么¶
API Gateway 是一条面向 AI Agent 的 Skill（分类 ai-agent，当前版本 v1.0.124，来源 clawhub，发布者 byungkyu）。官方在 SkillHub 上的简介是：通过 Maton 管理的 API 路由连接外部服务；仅在用户指定目标应用、账户和任务后使用；以读取、列表等操作为起点（完整说明见上游 Skill 文档）。
Skill 标记 requires_api_key=true，实际调用依赖 Maton 账户与已授权的应用连接，而不是在 Skill 里硬编码各家的 Client Secret。
- SkillHub 页面：https://www.skillhub.cn/skills/clawhub_byungkyu/api-gateway
- 官方入口：https://api.skillhub.cn/zcwl/api-gateway
- 上游仓库：https://clawhub.ai/byungkyu/api-gateway
截至 SkillHub 展示数据：评分 100000，下载 134687，安装 11601。
核心功能¶
以下能力均来自上游 Maton API Gateway Skill 文档，由本 Skill 指导 Agent 按步骤执行。
托管路由与 API 调用¶
用户已在 Maton 中连接的应用，可通过网关发起调用，凭证由网关注入，Agent 不必在对话或代码里持有长期密钥。
- 应用命令：按
maton <app> <resource> <verb>分层查看帮助，例如 Slack 频道列表、发消息等。 - 通用 API：对没有专用子命令的端点，使用
maton api，路径第一段为应用标识，其后为上游原生 API 路径。
maton slack channel list --types public_channel --limit 10
maton api '/google-mail/gmail/v1/users/me/messages'
maton api '/slack/api/conversations.list?types=public_channel&limit=10'
文档列出的支持范围包括 Gmail（邮件、线程、标签）、Slack（消息、频道、用户）、Stripe（客户、订阅、账户记录）等大量 SaaS；具体端点以各应用 references/ 与 maton --help 为准。
连接管理¶
连接表示「某个 Maton 账户下已授权的外部应用实例」。
maton connection list slack --status ACTIVE
maton connection create slack # 需用户明确同意
maton connection get {connection_id}
maton connection delete {connection_id} --yes
同一应用有多条连接时，用 --connection {connection_id} 或请求头 Maton-Connection 指定账户；未指定时使用最旧的 ACTIVE 连接。创建连接前 Skill 要求 Agent 确认具体应用与用户授权意图，不得自行发起授权。
触发器与事件¶
可对 GitHub、Stripe、Google Mail 等来源配置触发器，并管理目的地、查看与重放事件。
maton trigger list --source github --status ENABLED -L 50
maton trigger create --source github --event-type pull_request.opened ...
maton trigger event list --trigger {trigger_id} -L 1
maton trigger event replay {event_id} --trigger {trigger_id}
maton trigger event watch -t {trigger_id}
time 源支持按 cron 调度（schedule.elapsed），无需活跃连接。创建 destination 会把匹配事件持续转发到指定 URL，文档将其标为高风险操作，需单独向用户披露 URL、数据内容与持续性后再执行。
Functions（可选，非默认路径）¶
Maton 支持托管 Python 函数（创建、部署、调用、版本与环境变量）。Skill 明确：日常读邮箱、改记录应优先 maton api；仅当用户明确要求托管代码时才走 function 流程，且 deploy、invoke 均需分项审批。
安全与审批¶
Skill 将多条硬约束写给 Agent，例如：
- 创建连接、任何 POST/PUT/PATCH/DELETE（发消息、建记录、删资源等）前须 用户明确批准。
- 触发器目的地属于「持续外发通道」，不得作为顺手步骤创建，禁止把事件发到公共 request-bin 类服务。
maton trigger event watch --exec是唯一会执行本地脚本的路径，脚本须用户编写或审阅，且需单独批准。
安装与启用¶
安装 Skill（SkillHub）¶
按 SkillHub 官方说明，让 Agent 参照安装文档并安装指定坐标：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@clawhub_byungkyu/api-gateway`。
CLI 方式示例（skills 目录须指向当前 Agent 实际使用的路径，否则安装后不会被加载）：
command -v skillhub && skillhub --version
skillhub install @clawhub_byungkyu/api-gateway --dir <skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
上游 ClawHub 页面另提供 OpenClaw 安装命令 openclaw skills install @byungkyu/api-gateway；若你使用 OpenClaw 系客户端，以其文档为准。
安装 Maton CLI 并登录¶
网关调用依赖 Maton CLI（Skill 文档中版本示例为 @maton/cli@0.4.0，亦可通过 Homebrew 安装 maton 并 brew pin maton 固定版本）。
npm install -g @maton/cli@0.4.0
maton login
maton whoami --json
登录完成后配置写入 $HOME/.config/maton/config.toml，令牌由系统凭据存储管理。whoami 返回 authenticated: false 时应重新 maton login。
典型用法¶
下面是一条可复现的「先连上 Slack，再列频道」路径，与官方示例一致。
1、确认已登录
maton whoami --json
2、查看是否已有 Slack 连接
maton connection list slack --status ACTIVE
若无连接，在用户确认后创建并完成浏览器授权：
maton connection create slack
maton connection get {connection_id}
3、列出频道（只读）
maton slack channel list --types public_channel --limit 10
多账户时加上 --connection {connection_id}。
读 Gmail 未读、查 Stripe 客户等同理：先确认连接与任务，优先 maton api 或对应 maton <app> 子命令；写操作前按 Skill 要求向用户复述目标服务、资源与 payload 并等待批准。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的 Agent，希望用统一网关接 Slack/Gmail/Stripe 等，而不是每个项目重写 OAuth。
- 需要 Agent 按文档管理连接、触发器，并在改数据前停下来问用户的人。
限制与注意
- 必须能安装并登录 Maton CLI；Skill 本身不替代 Maton 账户与在各应用侧的授权。
- 标签
requires_api_key=true：密钥与令牌由 Maton 管理，Agent 仍须在对话中遵守 Skill 的审批规则，不能假设「只读 Skill」就可以随意创建连接或 destination。 - SkillHub 分发版本为 v1.0.124，上游 ClawHub 页面可能展示更高版本号；升级 Skill 或 CLI 前建议对照上游 release 说明。
- 用户线索中的「托管 API 网关」与 SkillHub 页上的 Maton 表述一致；若官方简介在 SkillHub 被截断，完整行为以 https://clawhub.ai/byungkyu/api-gateway 文档为准。
结尾¶
API Gateway 把 Maton 的连接、API 路由、触发器与安全审批约定写进 Agent Skill，适合在明确应用、账户与任务的前提下，让模型去列频道、读邮件、查支付对象，而不是在仓库里散落各家 OAuth 代码。安装与说明入口：https://www.skillhub.cn/skills/clawhub_byungkyu/api-gateway ，官方地址：https://api.skillhub.cn/zcwl/api-gateway 。
