前言¶
給 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 。
