vapi-calls
Advanced AI voice assistant for phone calls. Capable of persuasion, sales, restaurant bookings, reminders, and notifications.
- License 许可
- MIT
- 最近更新
- 2026-05-17
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- vapi-calls
- emoji
- 📞
- tools
- [ { "name": "make_vapi_call", "parameters": { "type": "object", "required": [ "phone_number", "first_message", "system_prompt" ], "properties": { "end_message": { "type": "string", "description": "Optional. Final phrase. Use 'DEFAULT' to skip override." }, "phone_number": { "type": "string", "description": "Recipient's phone number (E.164 format, e.g., +34669000000)." }, "first_message": { "type": "string", "description": "Initial greeting. Use 'DEFAULT' to use the agent's configured greeting." }, "system_prompt": { "type": "string", "description": "AI instructions. Use 'DEFAULT' to use the agent's configured model/prompt. If custom text is provided, the call will force GPT-4o Mini + endCall tool." } } }, "description": "Triggers an autonomous AI phone call with a specific mission and waits for the final report." } ]
- author
- César Morillas
- license
- MIT
- version
- 1.0.0
- requires
- { "env": [ "VAPI_API_KEY", "VAPI_ASSISTANT_ID", "VAPI_PHONE_NUMBER_ID", "WEBHOOK_BASE_URL" ], "pip": [ "requests" ], "bins": [ "python3" ] }
- repository
- https://github.com/vapi-ai/openclaw-vapi-calls
- description
- Advanced AI voice assistant for phone calls. Capable of persuasion, sales, restaurant bookings, reminders, and notifications.
02 资源文件 3
- 参考文档_meta.json283 B
- 参考文档package.json628 B
- 脚本scripts/vapi_calls.py8.6 KB
03 SKILL.md 正文
Vapi Calls - Agent Instructions
Use this skill to perform any task that requires voice interaction over the phone.
Configuration & Network Requirements
⚠️ IMPORTANT: This skill requires your machine to be reachable from the internet to receive real-time call updates.
1. Environment Variables
Configure these in your OpenClaw config.json (or Gateway env):
VAPI_API_KEY: Your Vapi Private API Key.VAPI_ASSISTANT_ID: The ID of the Vapi Assistant to use as a base.VAPI_PHONE_NUMBER_ID: The ID of the Vapi Phone Number.WEBHOOK_BASE_URL: Crucial. The public HTTPS URL where this agent is reachable (e.g.,https://my-claw.comorhttps://xyz.ngrok-free.app). Do not include a trailing slash.WEBHOOK_PORT(Optional): The local port to listen on (Default:4430).VAPI_LLM_PROVIDER: (Optional) Provider for Custom Mode (Default:openai).VAPI_LLM_MODEL: (Optional) Model for Custom Mode (Default:gpt-4o-mini).
2. Connectivity Setup
You must expose the WEBHOOK_PORT (default 4430) to the internet.
Option A: Cloudflare Tunnel (Recommended)
cloudflared tunnel --url http://localhost:4430
Option B: Ngrok
ngrok http 4430
Set WEBHOOK_BASE_URL to the generated URL (e.g., https://random-name.trycloudflare.com).
Usage
Custom Mission (Dynamic)
Provide a specific system_prompt. The system will automatically use GPT-4o Mini and enable the endCall tool. The AI will be able to hang up autonomously.
Native Agent (Static)
Pass "DEFAULT" for first_message, system_prompt, and end_message. The system will use the exact configuration (Model, Voice, Prompt) defined in the Vapi Dashboard.
Troubleshooting
- Call hangs / No report: Check if
WEBHOOK_BASE_URLis reachable from the internet. The Python script spins up a temporary server onWEBHOOK_PORTonly during the call. - API 400 Error: Check your
VAPI_PHONE_NUMBER_IDandVAPI_ASSISTANT_ID.
04 同仓库更多 Skills
zvukogram
Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.
zohomail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-recruit
Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows. Use this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-people
Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave. Use this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-mail
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
zoho-inventory
Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments. Use this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.