VAPI Calls

该 Skill 调用 Python 脚本和 Vapi API 发起自主 AI 语音电话，支持自定义话术、销售说服、餐厅预订、提醒与通知；脚本在通话期间于本地端口启动临时服务器接收实时更新，需把该端口经 Cloudflare Tunnel 或 ngrok 暴露到公网。

cmorillas99-cyber

热度 93.98

最近更新 2026-05-18 11:57:39

分类：自动化依赖：代码执行 / 第三方 API应用场景：自动化脚本 / 工作流 / 日程安排

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add vapi-calls

Metadata

name: vapi-calls
description: Advanced AI voice assistant for phone calls. Capable of persuasion, sales, restaurant bookings, reminders, and notifications.
emoji: 📞
author: César Morillas
version: 1.0.0
license: MIT
repository: https://github.com/vapi-ai/openclaw-vapi-calls
requires: {"env":["VAPI_API_KEY","VAPI_ASSISTANT_ID","VAPI_PHONE_NUMBER_ID","WEBHOOK_BASE_URL"],"bins":["python3"],"pip":["requests"]}
tools: [{"name":"make_vapi_call","description":"Triggers an autonomous AI phone call with a specific mission and waits for the final report.","parameters":{"type":"object","properties":{"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."},"end_message":{"type":"string","description":"Optional. Final phrase. Use 'DEFAULT' to skip override."}},"required":["phone_number","first_message","system_prompt"]}}]

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.com or https://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_URL is reachable from the internet. The Python script spins up a temporary server on WEBHOOK_PORT only during the call.
API 400 Error: Check your VAPI_PHONE_NUMBER_ID and VAPI_ASSISTANT_ID.