Vapi (vapi.ai) — OpenClaw Skill

# Vapi (vapi.ai) — OpenClaw Skill

Use this skill when you need to manage **Vapi voice agents** (assistants), calls, phone numbers, tools, and webhooks from an OpenClaw agent.

This skill is **API-first** (Vapi REST) and optionally integrates with the **Vapi CLI** for MCP docs / local workflows.

What you can do

Required secrets

Set one of:

How to provide the key (recommended)

Never paste the key into public logs.

Endpoints

Base URL:

Auth:

API reference:

Tooling options

This skill supports **both** approaches; you can decide later per deployment.

Option A — REST via helper script (works everywhere)

This repo includes a tiny Node helper:

Examples:

# list assistants
VAPI_API_KEY=... node skills/vapi/bin/vapi-api.mjs assistants:list

# create assistant
VAPI_API_KEY=... node skills/vapi/bin/vapi-api.mjs assistants:create \
  --name "Claw Con Concierge" \
  --modelProvider openai --model gpt-4o-mini \
  --voiceProvider 11labs --voiceId rachel

# start an outbound call (example shape; see swagger for required fields)
VAPI_API_KEY=... node skills/vapi/bin/vapi-api.mjs calls:create \
  --assistantId asst_xxx \
  --to "+14155551234" \
  --from "+14155559876"

Option B — Vapi CLI (good for interactive ops)

If `VAPI_MODE=cli`, prefer using the CLI for management tasks and fall back to REST if the CLI isn’t installed.

Docs:

Install:

curl -sSL https://vapi.ai/install.sh | bash
vapi login

Option C — MCP docs server for your IDE

This improves IDE assistance (Cursor/Windsurf/VSCode):

vapi mcp setup

Agent usage guidance

When the user asks for Vapi changes:

1. Clarify **scope**: assistants vs phone numbers vs webhooks vs tool calls.

2. Prefer **read-only** queries first (list/get) before destructive changes.

3. When creating an assistant, ask for:

- assistant name

- model provider/model

- voice provider/voice id

- tools/function calling needs

- webhook URL (if using server events)

4. When initiating calls, confirm:

- to/from numbers

- assistantId

- compliance constraints (recording, consent)

Files in this skill

Sources