Vapi Skill

What This Skill Does

The Vapi Skill enables seamless integration between your OpenClaw agent and the Vapi.ai ecosystem. It serves as a comprehensive interface for managing voice-based AI operations, allowing you to orchestrate assistants, calls, phone numbers, and webhooks directly through natural language or automated workflows. By supporting both a direct REST API approach and the official Vapi CLI, the skill provides flexibility for developers who prefer either script-based automation or interactive terminal-based management.

Installation

To integrate this skill into your OpenClaw project, run the following command in your terminal: clawhub install openclaw/skills/skills/colygon/vapi-skill

Once installed, you must configure your authentication credentials to enable communication with the Vapi platform. The recommended method is to set the VAPI_API_KEY environment variable in your Gateway secrets or local development shell. Never hardcode this key into your scripts or commit it to version control systems.

Use Cases

This skill is designed for high-level voice automation tasks:

1. Dynamic Assistant Deployment: Rapidly spin up new voice agents for specific campaigns or customer segments by defining models (e.g., GPT-4o) and voices (e.g., 11Labs) on the fly.
2. Outbound Call Orchestration: Automate cold outreach, appointment reminders, or customer verification calls programmatically.
3. Event-Driven Workflows: Configure webhooks to capture call data, transcriptions, and status updates, piping them back into your CRM or database.
4. Operational Monitoring: Use the skill to list active calls, retrieve assistant configurations, and troubleshoot connectivity issues via the Vapi API directly from your chat interface.

Example Prompts

1. "Create a new Vapi assistant named 'Support Agent' using GPT-4o-mini and the 11Labs 'rachel' voice."
2. "Initiate an outbound call from +14155559876 to +14155551234 using the assistant ID asst_8829."
3. "List all my existing Vapi assistants and show me the status of the latest calls."

Tips & Limitations

• Safety First: Always perform 'list' or 'get' queries before executing 'create' or 'delete' commands to avoid accidental modification of production assistants.
• Authentication: Using VAPI_API_KEY as a secret is mandatory. If you are working in a dev environment, ensure your VAPI_MODE is set appropriately—use api for background automation and cli if you need interactive debugging.
• Compliance: When configuring phone numbers and making outbound calls, ensure you comply with regional telecommunications regulations, including recording consent and proper Caller ID registration.