twilio

What This Skill Does

The Twilio skill for OpenClaw provides a secure, managed gateway to the Twilio API, enabling users to interact with SMS, voice calling, and account resource management capabilities directly from the OpenClaw environment. By leveraging Maton's managed OAuth integration, this skill abstracts the complexity of manual token refresh and authentication, allowing you to focus on building communication workflows. The skill serves as a proxy, automatically injecting your validated Maton API key into requests made to the Twilio platform, ensuring that your interactions with Twilio are authorized and efficient. Whether you are managing phone numbers, triggering automated SMS broadcasts, or building interactive voice response (IVR) systems, this skill streamlines the process through a consistent base URL structure.

Installation

To begin using this skill, ensure you have the OpenClaw environment set up. Install the skill by executing the command: clawhub install openclaw/skills/skills/byungkyu/twilio-api. Once installed, you must configure your Maton API key by setting the MATON_API_KEY environment variable. You can obtain your key by visiting your settings page at maton.ai/settings. Before issuing requests to the Twilio API, you must ensure a connection is established. You can list existing connections or create a new one using the provided control endpoints at https://ctrl.maton.ai. If you are initiating a new connection, follow the url link provided in the creation response to complete the OAuth handshake within your browser.

Use Cases

• Automated Alerts: Send SMS notifications to users based on system events, such as server monitoring thresholds or appointment reminders.
• Voice Communications: Trigger outbound voice calls to notify stakeholders of critical updates or to verify identity.
• Account Management: Programmatically manage phone numbers and audit your Twilio resource usage without leaving your terminal or workspace.
• Prototyping IVR: Build and test simple voice flows by interacting with Twilio's call resource endpoints.

Example Prompts

1. "Send an SMS to +15550123456 saying 'Your shipment is out for delivery' using my Twilio account."
2. "List all my currently active Twilio phone numbers and their capabilities."
3. "Initiate a test voice call to my registered number using the latest Twilio configuration."

Tips & Limitations

• Account SID Requirement: Most Twilio API endpoints require your Account SID. Use the /Accounts.json endpoint first to identify your specific SID.
• Authentication: Always ensure your MATON_API_KEY is kept secure and not hardcoded into scripts intended for public repositories.
• Scope: This skill is strictly for Twilio integrations. If you require functionality for other third-party messaging services or APIs, use the dedicated api-gateway skill instead.
• Latency: As this skill proxies requests through the Maton gateway, minor latency may occur compared to direct calls, but this is offset by the benefit of managed authentication.