用 api-gateway 技能把 OpenClaw 接入 100+ 外部服務：從 Notion 到 Google Calendar 的實戰

为什么我開始用 api-gateway

之前每次需要接外部服務，流程都挺痛苦的：找API文档、注册開發者帳號、產生Key、读OAuth流程、写授权程式碼……一个Notion集成搞下来没个半天出不来。SFD實驗室里的Agent经常需要读Notion里的任務、写Google Calendar的日程，这些重复劳动堆在一起很烦。

后来發現OpenClaw的技能库里有个 api-gateway，是 Maton.ai 提供的托管OAuth方案，宣称支援100+服務。试了几天，解決了大部分問題。这篇写實戰使用体验，不吹，说说真实情况。

api-gateway 是什么

一句话：它是一个托管的OAuth中间层。你不用自己管API Key、refresh token、權限范围——Maton帮你维护这层，OpenClaw Agent通过统一介面呼叫。

支援的服務包括：Google Workspace（Gmail、Calendar、Drive、Sheets）、Microsoft 365（Outlook、Teams、OneDrive）、GitHub、Notion、Slack、Airtable、HubSpot、Salesforce，以及一堆我没全用过的SaaS工具。

重要的安全说明：MATON_API_KEY只是你对Maton的身份驗證，它不等于你对Google/Notion的授权。每个服務都要单独走OAuth，使用者主动授权。这个设计是对的，不然一个Key泄露就全完了。

安裝和初始化

技能本身不需要安裝，OpenClaw工作區里直接用就行。第一次使用要設定 MATON_API_KEY，从 maton.ai 注册帳號后在控制台拿到。

設定好之后，在OpenClaw里说"帮我連接Notion"，它会走一遍OAuth授权流程，给你一个授权链接，你在浏览器里完成授权，連接就建立好了。之后同类請求不需要重新授权。

實戰：让Agent自動同步Notion任務到Google Calendar

这是我在SFD實驗室真实用的場景。專案管理在Notion，日程在Google Calendar，两边手动同步太费时间。

連接好两个服務之后，给Agent的指令大概是这样：

读取Notion資料库"任務列表"里本周所有状态为"进行中"的任務，把截止日期和任務名同步到Google Calendar，建立对应的事件。如果Calendar里已经有同名事件就跳过。

Agent会：

呼叫Notion API读取資料库，过滤本周+进行中的条目
呼叫Google Calendar API查已有事件（避免重复）
批次建立新事件
返回同步摘要

整个过程不用写一行程式碼。我測試下来同步速度还行，10条任務大概15-20秒完成，主要耗时在OAuth呼叫往返。

實戰二：从 GitHub Issues 產生 Airtable 看板

SFD實驗室的開發任務在Gitea，但客户反馈在GitHub的issue tracker（两套系統是历史遗留問題）。我需要把GitHub issues定期同步到Airtable，让非技術團隊也能看进度。

指令：

读取GitHub仓库 sfd-lab/client-feedback 里所有open状态的issues，按标签分类（bug/feature/question），写入Airtable的"客户反馈"表格，欄位：标题、URL、标签、建立时间、状态。

这个場景api-gateway跑得很稳。Airtable写入有速率限制，Agent会自動處理429錯誤并退避重试，这个细节让我省了不少心。

踩过的坑

權限范围要想清楚再授权。 第一次授权Google Calendar时我随手点了"全部權限"，后来發現Agent有能力删除我的日历事件……赶紧重新授权，只给读写權限，不给删除。OAuth權限能细化就细化，不要图省事给全权。

token过期不会自動提醒。 Maton会帮你刷新access token，但如果使用者主动在Google那边撤销了授权，下次呼叫才会失败，不会有预警推送。我建议对关键集成加一个每日心跳检测，确认連接还活着。

某些服務的API覆盖不全。 Notion的block-level操作（比如往某个具体页面的特定位置插入內容）我就遇到过api-gateway没暴露对应介面的情况，只能降级到直接调Notion原生API。api-gateway更适合"读資料+写資料"这类标准操作，复杂的結構化操作可能要绕行。

适合哪些場景

说实话，api-gateway最大的价值是降低接入门槛。如果你不是開發者，或者不想花时间配OAuth，它能帮你快速跑通。SFD實驗室里非技術的Agent（比如负责內容的小狐狸🦊）用api-gateway读Notion文档是完全没問題的，不需要她懂OAuth流程。

如果你是開發者，有时候直接写SDK更灵活，但api-gateway的价值在于统一管理——所有服務的授权状态在一个地方，不用分散在各个專案的.env檔案里。

總結：适合快速原型、跨服務資料流转、非技術團隊授权接入这三类場景。复杂业务逻辑还是走自建API层更稳。