Vapi (vapi.ai) — OpenClaw 技能

当你需要从 OpenClaw 智能体管理 Vapi 语音助手、通话、电话号码、工具和 Webhook 时，请使用此技能。

此技能采用 API 优先（Vapi REST）方式，并可选择性地集成 Vapi CLI，以支持 MCP 文档或本地工作流。

功能概览

• 创建/更新/列出 助手
• 启动/查看/结束 通话
• 管理 电话号码
• 创建/管理 工具（函数调用）
• 配置 Webhook 并查看事件

必需的密钥

请设置以下密钥之一：

• VAPI_API_KEY（推荐） — Vapi 控制面板的 API 密钥。

如何提供密钥（推荐方式）

• 将其存储为 Gateway 的密钥或环境变量（首选），或
• 在运行辅助脚本前，在 shell 中导出该密钥。

切勿将密钥粘贴到公共日志中。

API 端点

基础 URL：

• https://api.vapi.ai

认证方式：

• Authorization: Bearer $VAPI_API_KEY

API 参考文档：

• https://api.vapi.ai/api (Swagger)

工具选项

此技能支持 两种 方式；您可以根据部署需求选择。

• 设置 VAPI_MODE=api 以优先使用 REST API（默认）
• 设置 VAPI_MODE=cli 以优先使用 Vapi CLI（交互式）

选项 A — 通过辅助脚本使用 REST（通用方案）

本仓库包含一个轻量级 Node.js 辅助脚本：

• skills/vapi/bin/vapi-api.mjs

使用示例：

# 列出助手
VAPI_API_KEY=... node skills/vapi/bin/vapi-api.mjs assistants:list

# 创建助手
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

# 发起外呼（示例结构；完整必填字段请参考 Swagger 文档）
VAPI_API_KEY=... node skills/vapi/bin/vapi-api.mjs calls:create \
  --assistantId asst_xxx \
  --to "+14155551234" \
  --from "+14155559876"

选项 B — Vapi CLI（适合交互式操作）

如果设置 VAPI_MODE=cli，则优先使用 CLI 进行管理任务；如果 CLI 未安装，则回退到 REST API。

文档：
- https://docs.vapi.ai/cli
- https://github.com/VapiAI/cli

安装：

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

选项 C — 为你的 IDE 配置 MCP 文档服务器

这可以提升 IDE（如 Cursor/Windsurf/VSCode）的辅助功能：
- https://docs.vapi.ai/cli/mcp

vapi mcp setup

智能体使用指南

当用户请求进行 Vapi 变更时：

1. 明确范围：确认是助手、电话号码、Webhook 还是工具调用。
2. 优先执行只读查询：在进行破坏性更改前，先执行列表/获取操作。
3. 创建助手时，请询问：
   • 助手名称
   • 模型提供商/模型
   • 语音提供商/语音 ID
   • 工具/函数调用需求
   • Webhook URL（如需接收服务器事件）
4. 发起通话时，请确认：
   • 主叫/被叫号码
   • 助手 ID
   • 合规性限制（录音、同意）

技能文件

• skills/vapi/SKILL.md — 本文档
• skills/vapi/bin/vapi-api.mjs — 轻量级 REST 辅助脚本

参考来源

• Vapi 文档简介：https://docs.vapi.ai/quickstart/introduction
• Vapi CLI：https://github.com/VapiAI/cli
• Vapi MCP：https://docs.vapi.ai/cli/mcp
• Vapi API (Swagger)：https://api.vapi.ai/api
• 示例服务器 (Node)：https://github.com/VapiAI/example-server-javascript-node
• OpenClaw：https://github.com/openclaw/openclaw