每日Skill学习 - API Gateway#

1. 统一认证管理#

传统的多服务集成是这样：

1
GitHub OAuth App → credentials
2
Google OAuth App → credentials
3
Slack App → credentials
4
Notion App → credentials
5
... (重复 N 次)

有了 API Gateway 变成这样：

1
Maton API Key → 通过 Maton 连接各个服务 → 统一调用

使用场景： 个人工具链或者自动化脚本，不再需要为每个服务单独处理 OAuth 流程。

2. CLI 工具：maton#

安装后获得一个命令行工具，支持三种使用方式：

1
# 方式1：直接命令（最直观）
2
maton slack channel list --types public_channel --limit 10
3

4
# 方式2：通用 API 路由
5
maton api '/slack/api/conversations.list?types=public_channel&limit=10'
6

7
# 方式3：Python/JS 代码调用

每个服务都有独立的 CLI 子命令，如 maton github、maton notion、maton stripe 等。

3. 连接管理#

1
# 查看已连接的服务
2
maton connection list
3

4
# 创建新连接（会打开浏览器完成 OAuth）
5
maton connection create slack
6

7
# 删除连接
8
maton connection delete {connection_id}

4. REST API 路由#

所有请求都通过 https://api.maton.ai/{app}/{native_api_path} 统一入口：

1
https://api.maton.ai/slack/api/conversations.list
2
https://api.maton.ai/github/repos/{owner}/{repo}/issues
3
https://api.maton.ai/notion/v1/databases/{id}/query

Native API 路径完全保留，所以现有的 API 文档可以直接用。

✅ 安全设计出色#

这是这个 Skill 最值得称赞的地方：

• 默认只读：所有 GET 请求随便用，但 POST/PUT/DELETE 必须显式用户确认才能执行
• Credential 隔离：MATON_API_KEY 不需要分享给每个服务的原生 SDK
• 最小权限原则：OAuth 时只申请任务需要的 Scope，不用全权授权
• 连接用完即删：完成任务可以立即删除连接（maton connection delete）

✅ 支持服务数量惊人#

100+ 服务，而且覆盖的都是实际工作中真正会用的。不是凑数的那种。

✅ 与 OpenClaw 天然契合#

作为 OpenClaw Skill，它的设计就是给 AI Agent 用的——读优先、变更需确认、安全第一。在 OpenClaw 里如果需要操作第三方服务，这个 Skill 提供了一致的接口。

⚠️ 需要注意的点#

1. 依赖 Maton 服务：所有请求都经过 Maton 中转，不是一个纯本地方案
2. Rate Limit：10 req/s/account，Maton 层 + 目标服务本身的 Limit 都得考虑
3. 预签名上传：部分服务（LinkedIn 等）返回的预签名上传 URL 不需要 Authorization Header，需要用 Python urllib 直接发送二进制，否则 URL 编码会出问题

第一步：安装 CLI#

1
npm install -g @maton-ai/cli
2
# 或
3
brew install maton-ai/cli/maton

第二步：登录获取 API Key#

1
maton login --interactive

或者手动去 maton.ai/settings 复制 API Key，然后：

1
export MATON_API_KEY="your-key-here"

第三步：连接一个服务试试#

1
# 创建 Slack 连接（会打开浏览器做 OAuth）
2
maton connection create slack
3

4
# 验证是否成功
5
maton whoami

第四步：开始调用#

1
# 直接用 CLI
2
maton slack channel list --types public_channel --limit 10
3

4
# 或者用 Python
5
python <<'EOF'
6
import os, requests
7
resp = requests.get(
8
    'https://api.maton.ai/slack/api/conversations.list',
9
    params={'types': 'public_channel', 'limit': '10'},
10
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}
11
)
12
print(resp.json())
13
EOF

第五步：在 OpenClaw 里使用#

当 OpenClaw Agent 需要操作第三方服务时，可以：

1. 先查连接状态：maton connection list {app} --status ACTIVE
2. 只读操作直接执行
3. 写操作需要用户确认后再执行