Vapi

What This Skill Does

The Vapi skill for OpenClaw provides a powerful interface for interacting with the Vapi.ai voice infrastructure. It allows users to manage the entire lifecycle of voice AI agents directly from their terminal or via OpenClaw's natural language interface. Whether you are managing assistants, phone numbers, or complex function-calling tools, this skill acts as a bridge between your environment and the Vapi REST API or Vapi CLI. It is designed to be flexible, supporting both production-grade REST API calls for automated pipelines and interactive CLI commands for rapid development and manual configuration.

Installation

To integrate this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/colygon/vapi. Once installed, you must provide your authentication credentials. The recommended method is to set the VAPI_API_KEY as a secure environment variable or a Gateway secret. If you prefer using the Vapi CLI, ensure you install it by running curl -sSL https://vapi.ai/install.sh | bash and completing the vapi login process. You can toggle between modes by setting the VAPI_MODE environment variable to either api or cli.

Use Cases

• Automated Call Campaigns: Use the skill to programmatically trigger outbound calls with specific assistant configurations for lead outreach or appointment reminders.
• Agent Prototyping: Rapidly create, test, and tweak voice assistant configurations (such as model providers, voice IDs, and system prompts) using natural language prompts without leaving your workflow.
• Event Monitoring: Integrate webhooks to track call logs and events in real-time, allowing you to feed post-call data into your broader analytics platform or CRM.
• Tool Management: Define and manage server-side function calling, allowing your voice agents to interact with external databases or APIs seamlessly.

Example Prompts

1. "Create a new Vapi assistant named 'SupportBot' using GPT-4o-mini and the 11labs Rachel voice."
2. "List all my active Vapi assistants and show their current phone number configurations."
3. "Initiate a test call from +14155559876 to +14155551234 using the assistant ID asst_8832."

Tips & Limitations

Always follow the principle of least privilege; prefer read-only operations for gathering information before executing destructive updates or call triggers. Be mindful that initiating outbound calls may incur costs or violate compliance regulations if not properly configured; always review your recording and consent settings. If you encounter issues with API responses, check the Vapi Swagger documentation for the latest schema definitions. When utilizing the CLI mode, ensure that your local environment is correctly authenticated to prevent authorization errors during execution.