api-gateway

What This Skill Does

The api-gateway skill acts as a secure, managed bridge between your AI agent and over 100 third-party services, including Slack, Google Workspace, Notion, Airtable, and HubSpot. Instead of dealing with complex OAuth flows, token refreshes, or manual API credential management, this skill uses a passthrough proxy provided by Maton.ai. It automatically injects the necessary OAuth tokens into your requests, allowing your agent to read, write, and interact with external data as if it were a native component of your agent's ecosystem. Whether you need to fetch recent emails, post automated messages to a Slack channel, or update records in a CRM, the api-gateway handles the heavy lifting of authentication and protocol negotiation.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/kdegeek/api-gateway-1

Once installed, ensure you have your Maton.ai API key. You can obtain this by signing into https://maton.ai and visiting the settings page. Set this as your environment variable:

export MATON_API_KEY="YOUR_API_KEY"

Finally, authorize your specific services via the Maton connection flow. Use the https://ctrl.maton.ai/connections endpoint to verify that your services are in an 'ACTIVE' state before attempting requests.

Use Cases

This skill is perfect for agents designed to automate business workflows. Common use cases include:

• Cross-Platform Synchronization: Automatically copying information from a Google Doc or Sheet into a Notion database.
• Operational Alerts: Triggering Slack or Microsoft Teams notifications when certain criteria are met in your monitoring tools.
• CRM Management: Fetching HubSpot leads, performing lead qualification via AI, and updating status fields automatically.
• Email Automation: Parsing incoming Gmail messages and drafting categorized responses or forwarding urgent notifications to internal tools.

Example Prompts

1. "Check my Slack connection status, then send a message to the #general channel saying 'Daily report processed successfully'."
2. "List my active API connections and then fetch the last 5 messages from my Gmail inbox to summarize them for me."
3. "Fetch the latest records from my Airtable project tracker and highlight any tasks marked as overdue."

Tips & Limitations

• Security: The MATON_API_KEY does not grant global access; it only provides the agent with the ability to trigger authorized connections. Always scope your OAuth authorizations to the minimum necessary access required for your specific workflows.
• Path Formatting: Remember that the API Gateway requires a specific path prefix corresponding to the app name (e.g., /google-mail/ for Gmail). Mismatched prefixes will result in routing errors.
• Monitoring: Always monitor the connection status via the /connections endpoint to catch expired or revoked OAuth tokens before your automation scripts fail.