Maton AI

通过 Maton 的 OAuth 连接管理功能，将您的 AI 智能体接入各类 SaaS 工具。本技能提供以下能力：

• 完整 UI 仪表盘 — 配置 API 密钥、查看连接状态、启动 OAuth 流程
• 多应用支持 — Gmail、Slack、Notion、HubSpot、Jira、Google Workspace 等
• 连接管理 — 创建、监控与删除应用连接
• API 密钥集成 — Maton API 密钥显示在 API Keys 标签页中，便于快速配置

概述

Maton 提供统一 API，用于通过 OAuth 协议连接各类 SaaS 工具。完成连接后，您既可通过 Maton 的 AI 能力与这些工具交互，也可直接调用其原生 API。

前提条件

1. Maton 账户 — 访问 maton.ai 注册账号
2. API 密钥 — 在 Maton 控制台中获取您的 API 密钥
3. Clawdbot 网关 — 版本需为 v2026.1.0 或更高，并已启用 UI

快速入门

步骤 1：获取您的 API 密钥

1. 访问 maton.ai 并登录
2. 进入 Settings → API Keys
3. 创建或复制您的 API 密钥

步骤 2：在 Clawdbot UI 中配置

选项 A：通过 API Keys 标签页配置

1. 打开 Clawdbot 仪表盘 → Settings → API Keys
2. 在 Environment Keys 区域中找到 “Maton”
3. 输入您的 API 密钥并点击 Save

选项 B：通过 Maton 标签页配置

1. 打开 Clawdbot 仪表盘 → Tools → Maton
2. 点击 Configure
3. 粘贴您的 API 密钥
4. 点击 Save

步骤 3：连接应用

1. 进入 Tools → Maton
2. 点击 Connect App，然后选择目标应用（例如 Gmail、Slack）
3. 在弹出窗口中完成 OAuth 流程
4. 当状态显示为 ACTIVE 时，表示连接已就绪

支持的应用

Maton 支持 50+ 款 SaaS 应用，包括：

API 参考文档

基础 URL

https://ctrl.maton.ai

认证方式

所有请求均需携带 Bearer Token：

curl https://ctrl.maton.ai/connections 
  -H "Authorization: Bearer YOUR_API_KEY"

接口端点

连接状态

架构设计

配置存储

Maton API 密钥保存在主 Clawdbot 配置文件中：

{
  "env": {
    "MATON_API_KEY": "your-api-key-here"
  }
}

该配置与 API Keys 标签页集成，实现密钥的集中化管理。

后端 RPC 方法

UI 组件

安装说明

详细集成指南请参阅 reference/README.md。

快速集成步骤

1. 将后端处理器复制至 src/gateway/server-methods/maton.ts
2. 将 UI 文件复制至 ui/src/ui/views/ 和 ui/src/ui/controllers/
3. 在导航栏中添加 “maton” 标签页
4. 将 MATON_API_KEY 添加至 API 密钥自动发现机制
5. 重新构建并重启服务

UI 功能特性

Maton 标签页（Tools → Maton）

• 显示连接状态（含 active/pending 数量统计）
• API 密钥配置表单
• 已连接应用列表，附带状态徽章
• 用于新建连接的应用选择模态框
• 一键启动 OAuth 流程

API Keys 标签页集成

• 在 Environment Keys 区域中显示 “Maton” 条目
• 提供 API 密钥直输字段
• 支持 Save / Clear 操作

安全性

最佳实践建议：

• 定期轮换 API 密钥
• 定期审查已连接的应用
• 及时断开未使用的连接

故障排查

“Unauthorized” 错误

• 确认 API 密钥输入正确
• 检查密钥是否已被撤销
• 如需，可在 Maton 控制台中重新生成密钥

连接卡在 PENDING 状态

• OAuth 流程未完成
• 尝试再次使用 OAuth URL
• 若 URL 已过期，请删除后重新创建连接

连接状态显示为 FAILED

• OAuth Token 可能已过期
• 请删除该连接并新建一个

API Keys 标签页中未显示 Maton

• 请确认您运行的是 Clawdbot v2026.1.0 或更高版本
• 网关重启后请刷新页面

参考文件

• reference/maton-backend.ts — 网关 RPC 处理器
• reference/maton-controller.ts — UI 控制器逻辑
• reference/maton-views.ts — UI 渲染（Lit）
• reference/README.md — 安装指南

支持资源

• Maton：maton.ai
• ClawdHub：clawdhub.com/skills/maton
• Discord：discord.com/invite/clawd