用 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层更稳。