AI 에이전트가 단일 Maton API key를 사용하여 100개 이상의 타사 API와 상호 작용할 수 있도록 하는 관리형 OAuth proxy입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install api-gateway-tmp
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 api-gateway-tmp 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
API Gateway란 무엇인가요?
API Gateway는 복잡한 타사 통합 환경을 단순화하기 위해 Openclaw Skills용으로 설계된 강력한 패스스루 proxy입니다. 개발자와 AI 에이전트는 개별 OAuth 흐름이나 token 새로 고침을 수동으로 관리하지 않고도 Google Workspace, Microsoft 365, GitHub 및 Slack과 같은 서비스에서 직접 기본 API 엔드포인트를 호출할 수 있습니다.
표준화된 기본 URL을 통해 요청을 라우팅함으로써 게이트웨이는 필요한 인증 token을 자동으로 주입합니다. 이를 통해 MATON_API_KEY가 중앙 인증 메커니즘 역할을 하는 동시에 외부 서비스에 대한 엄격한 사용자 인증 액세스를 유지하는 안전하고 범위가 지정된 간소화된 개발 환경을 보장합니다.
API Gateway 활용 사례
- 기본 Slack 메시지 또는 Gmail 회신을 보내 통신을 자동화합니다.
- HubSpot, Salesforce 또는 Airtable과 같은 플랫폼에서 데이터를 동기화합니다.
- Jira 문제, Notion 페이지 또는 Google Calendar 이벤트를 생성하여 생산성 도구를 관리합니다.
- Brave Search, Exa 또는 Tavily 기본 엔드포인트를 사용하여 고급 조사를 수행합니다.
- 파일 관리를 위해 Dropbox, Box 및 OneDrive와 같은 클라우드 스토리지 공급자와 상호 작용합니다.
API Gateway 작동 원리
- 사용자는 Maton.ai에서 인증을 받고 MATON_API_KEY를 얻습니다.
- OAuth 흐름을 트리거하기 위해 제어 평면을 통해 특정 앱(예: Slack)에 대한 연결이 설정됩니다.
- 에이전트는
[https://gateway.maton.ai/](https://gateway.maton.ai/){app}/{native-api-path}형식을 사용하여 게이트웨이에 요청을 보냅니다. - API Gateway는 필요한 앱을 식별하고 해당 사용자의 활성 OAuth token을 검색합니다.
- 게이트웨이는 올바른 header 및 매개변수와 함께 요청을 대상 서비스의 기본 API로 전달합니다.
- 대상 API의 응답은 에이전트에게 직접 전달됩니다.
API Gateway 설정 가이드
Openclaw Skills에서 이를 사용하려면 환경 변수를 설정하고 연결을 초기화하세요.
# Maton API Key 설정
export MATON_API_KEY="YOUR_API_KEY"
# 서비스(예: Slack)에 대한 새 연결 생성
curl -X POST https://ctrl.maton.ai/connections \
-H "Authorization: Bearer $MATON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"app": "slack"}'
생성 명령을 실행한 후 브라우저에서 제공된 URL을 열어 서비스를 인증합니다.
API Gateway 데이터 스키마 및 분류 체계
게이트웨이는 예측 가능한 라우팅 스키마를 사용하여 요청을 기본 공급자에 매핑합니다.
| 구성 요소 | 설명 | 예시 |
|---|---|---|
| 기본 URL | 게이트웨이 진입점 | [https://gateway.maton.ai](https://gateway.maton.ai) |
| 앱 이름 | 서비스의 고유 식별자 | google-mail |
| 기본 경로 | 대상 문서에 정의된 엔드포인트 | gmail/v1/users/me/messages |
| 연결 ID | 특정 계정을 지정하기 위한 선택적 header | Maton-Connection: <uuid> |
status, creation_time, app 유형과 같은 연결에 관한 모든 메타데이터는 [https://ctrl.maton.ai](https://ctrl.maton.ai) 엔드포인트를 통해 관리됩니다.
API Gateway 고급 기능
- 동일한 앱의 여러 인스턴스를 관리하기 위해 Maton-Connection header를 통한 다중 계정 지원.
- 자동 OAuth token 새로 고침 및 수명 주기 관리.
- 완전한 기본 API 패리티를 위한 사용자 지정 header 및 쿼리 매개변수 통과.
- Jobber, Linear 및 Monday.com과 같은 서비스에 대한 GraphQL 지원.
- QuickBooks realmId와 같은 복잡한 통합을 위한 전문 경로 교체.
SKILL.md
로드 중
관련 Openclaw 스킬
AWS VPC 네트워크 보안 감사
AWS VPC 아키텍처, 보안 필터링 및 연결 구성을 평가하기 위한 전문 읽기 전용 감사 도구입니다.
Java Code Reviewer
git diff 또는 소스 파일에서 구조화된 Java 코드 리뷰 보고서를 생성하기 위한 고성능 자동화 도구입니다.
YY Live Stream Assistant
YY Live 공개 정보, 호스트 규정 및 플랫폼 활동 정리를 위한 자동화된 데이터 추출 스킬입니다.
eBay Review Checker
eBay 생태계를 위해 특별히 설계된 가짜 리뷰, 시간 클러스터링 및 피드백 조작을 감지하는 고급 진위 분석기입니다.
Zhangyue iReader 콘텐츠 어시스턴트
Zhangyue iReader 플랫폼을 위한 전문화된 콘텐츠 검색 및 연구 자동화 기능입니다.
트렌딩 섬 목적지 가이드
바이럴 여행지를 위한 최적화된 섬 일정, 사진 가이드 및 실시간 교통 데이터를 생성하는 지능형 여행 계획 스킬입니다.
추천*
