API Gateway 是 Maton 的 OpenClaw Skill：它教 Agent 通过 Maton 网关调用你已经连接的第三方应用 API。它不是通用浏览器，也不会因为安装 Skill 就自动获得 Slack、Gmail 或其他账户的权限。[1]
这份指南用“只列出 Slack 公开频道”作为第一次任务，帮助你分别核对三件事：Skill 已安装、Maton CLI 已登录、Slack 连接已由你授权。示例是可照做的练习，不是本站亲测结果。
安装 Skill 和 Maton CLI 是两步
在已安装 OpenClaw 的终端，把 Skill 安装到当前工作区：
openclaw skills install @byungkyu/api-gateway
随后核对来源与扫描状态：
openclaw skills verify @byungkyu/api-gateway
OpenClaw 文档建议把社区 Skill 当作不可信代码，启用前先阅读；若 verify 报失败，不要用强制选项绕过。[3] [4]
再单独安装 Maton CLI。ClawHub 当前版本文件（1.2.32）固定使用 0.5.0：
npm install -g @maton/cli@0.5.0
这条命令安装的是底层 maton 程序，不是 Skill。若机器不允许全局 npm 安装，先查看 Maton 提供的其他安装方式；不要把未固定版本的安装命令与旧版登录参数混用。[1]
登录 Maton，不等于连接 Slack
在终端运行 maton login。对 ClawHub 1.2.32 所配的 CLI，流程是：打开命令打印的登录链接，在网页完成登录，再把网页给出的验证码交给本地命令：
maton login
maton login --code <网页显示的验证码>
maton whoami --json
最后一条应显示 authenticated: true。不要把验证码、令牌、登录链接或整个终端 JSON 粘到聊天记录里。当前 Maton 在线 CLI 文档展示的登录说明与 ClawHub 包内指引有差别，所以按已安装版本的帮助和版本文件操作，并在升级前重新核对。[1] [5]
Maton 登录只建立你与 Maton CLI 的身份。调用某个应用还需要独立的应用连接：到 Maton Connections 控制台选择 Slack，查看需要的权限并由你本人完成 OAuth 授权。检查其状态为 ACTIVE 后再继续；没有活动连接就先停下，不要让 Agent 自行创建连接。[6] [7]
首次任务：只读最多 10 个公开频道
先在本地终端检查已有连接：
maton connection list slack --status ACTIVE
如果有多个 Slack 工作区，先在本地辨认并选定一个。连接列表可能带账户元数据或临时授权 URL；不要把整段输出复制给 Agent。只提供你选定的 connection ID 即可。未指定连接时，gateway 默认可能选用最早建立的活动连接，容易读错工作区。[1] [8]
在 OpenClaw 对话中可以这样发起练习：
使用 api-gateway。先只检查 Maton 登录状态和已有 ACTIVE Slack 连接；不要新建、删除或修改连接。
如果没有 ACTIVE Slack 连接就停止并告诉我由我本人授权。如果有多个连接，先让我选择，不要暴露邮箱、授权链接或令牌。
得到我的选择后，只读取该连接中最多 10 个 public Slack channel 的名称和 ID。
不要发消息、改数据、创建函数或触发器；不要输出密钥、令牌、私密频道或消息正文。遇到需要写入或扩大权限的情况先停止并询问我。
这条练习的验收点是：Maton 身份检查通过；选中的 Slack 连接明确为 ACTIVE；调用显式指定该连接；返回不超过 10 个公开频道的名称和 ID；没有写入动作。还要检查 Slack 返回的业务字段（例如 ok）——HTTP 请求成功不一定代表上游 API 的业务操作成功。[1] [8]
如果你想手动调用同一条只读命令，先使用本机 CLI 查询真实连接 ID，再运行：
maton slack channel list --types public_channel --limit 10 --connection <你选定的ACTIVE连接ID>
尖括号内容是占位符，要换成你自己的 ID。不要把真实连接 ID、账户元数据或输出截图公开发布。
常见卡点
| 现象 | 先检查什么 |
|---|---|
whoami 未认证或 gateway 返回 401 | Maton CLI 登录状态；不要把 Slack 网页登录当成 Maton 登录。 |
| 400 / 没有可用连接 | Slack 连接是否存在且为 ACTIVE，连接是否属于 Slack。 |
| 403 | 当前 Slack 授权是否包含该端点所需 scope；由账户持有人核对授权，不要自动扩权。 |
| 404 | 连接 ID 是否属于当前 Maton 账户；也可能是 Slack 资源 ID 或接口路径错。 |
| 429 | 达到 Maton 或上游限流；查看 Retry-After 或服务端提示后再决定何时重试。 |
| 结果来自错误工作区 | 使用 --connection 明确指定 ID，不依赖默认选择。 |
这些状态码可能来自 Maton，也可能由第三方 API 原样返回；若响应有 Proxy-Status，先看它指示哪一层产生错误。[7] [8] [10]
第一次不要部署自动化
这个 Skill 还介绍 hosted functions、triggers、webhook destinations、event replay 等功能。它们会创建持久资源、运行代码或转发事件，权限与影响范围明显高于一次 API 读取。日常读取和查询不需要部署 function。先完成只读调用；只有具体目标、处理数据、连接身份、网络范围与回收计划都说清楚后，才讨论相应自动化。任何写入、创建连接/函数/触发器、重放事件或运行本地 handler 都应按当前 Skill 指引单独征得明确确认。[1]
费用与版本边界
截至 2026-10-31，Maton 定价页列出的 Hobby 档为免费、最多 30 个活动连接、每秒 10 次请求；部分 premium apps 可能需付费档，第三方应用也有自己的费用、权限和 API 限制。安装 Skill 本身不等于所有连接免费可用，使用前重新看当前价格与应用目录。[7] [9]
ClawHub 版本 API 当日返回最新发布 1.2.32，该版本文件把 CLI 固定为 @maton/cli@0.5.0；页面渲染出来的旧安装片段仍显示 0.4.0。以版本文件中的明确固定版本为准，升级时重新比较版本记录和命令。本文没有连接 Maton 或 Slack，也未执行安装或 API 调用；上手示例的输出需由你在自己的授权范围内核对。[1] [2] [11]