A comprehensive telecommunications bridge for AI agents to handle SMS, voice, verification, and number management via the Vonage API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install vonage
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install vonage using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Vonage?
The Vonage skill is a high-performance integration designed to bring full-scale telecommunication capabilities to your AI workflows. As part of the Openclaw Skills ecosystem, this tool allows agents to interact directly with the Vonage platform to send text messages, initiate programmable voice calls, and manage authentication through the Verify API. It is written in pure Python 3.10+ using only the standard library, ensuring zero-dependency deployment and maximum security for developers building automated communication systems.
Vonage Use Cases
- Automated SMS notifications and status updates triggered by agent workflows.
- Programmatic voice call initiation with custom NCCO (JSON) instructions for interactive voice response.
- Secure two-factor authentication and identity verification using the Verify API.
- Automated procurement and management of virtual phone numbers across international regions.
- Real-time account monitoring and balance checking for telecommunication resource management.
How Vonage Works
- The AI agent identifies a communication requirement and triggers the vonage.py script with the appropriate subcommand.
- The script retrieves the VONAGE_API_KEY and VONAGE_API_SECRET from the environment to authorize the request.
- The skill communicates with Vonage endpoints to execute the requested action, such as sending an SMS or listing available numbers.
- The raw API response is processed and transformed into a structured JSON format.
- The agent parses the JSON output to confirm success or handle errors as part of the broader Openclaw Skills execution loop.
Vonage Setup
To utilize this skill within your Openclaw Skills environment, ensure you have Python 3.10+ installed and configure your credentials as environment variables:
export VONAGE_API_KEY="your_api_key_here"
export VONAGE_API_SECRET="your_api_secret_here"
You can then test the connectivity by checking your account balance:
python3 scripts/vonage.py get-balance
Vonage Data Schema & Taxonomy
The Vonage skill utilizes standard JSON formatting for all outputs to maintain consistency within Openclaw Skills. Below is the data structure for common operations:
| Feature | Output Type | Primary Fields |
|---|---|---|
| SMS | JSON Object | message-id, to, remaining-balance, status |
| Voice Calls | JSON Object | uuid, conversation_uuid, direction, status |
| Verification | JSON Object | request_id, status, error_text |
| Numbers | JSON Array | msisdn, country, type, features |
| Applications | JSON Array | id, name, capabilities, keys |
Vonage Advanced Features
- NCCO Integration: Support for complex Voice API workflows via JSON-defined Control Objects.
- Mobile Number Portability: Search and buy mobile-lvn or toll-free numbers programmatically.
- Multi-Application Management: Create, list, and configure multiple Vonage applications for different agent roles.
- Zero-Dependency Architecture: Optimized for speed and security by avoiding third-party package overhead in Openclaw Skills.
- Verification Lifecycle: End-to-end support for sending and checking verification codes in a single tool.
SKILL.md
Loading
Related Openclaw Skills
Voice Transcriber
An AI-powered voice transcription and archival tool that converts audio files into searchable text for agent workflows.
Voice Transcriber
A high-performance audio transcription and voice note archival tool powered by Deepgram Nova-3 for Openclaw Skills users.
Voice Agent Builder
A developer-centric toolkit for building and managing sophisticated Voice AI agents across Vapi, Bland.ai, and Retell platforms.
Voice Agent Builder
A comprehensive toolkit for building, configuring, and managing AI-powered voice agents across multiple telephony providers.
Wave Accounting
A streamlined CLI tool for managing Wave accounting, including invoices, customers, and transactions for small businesses.
Wise
A comprehensive automation tool for managing international transfers, multi-currency accounts, and real-time exchange rates via AI agents.
Featured*
