Vapi Calls - Agent Instructions

---

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):

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