Vapi（vapi.ai）—— OpenClaw 技能

当您需要通过 OpenClaw agent 管理 Vapi 语音代理（助手）、通话、电话号码、工具及 Webhook 时，请使用此技能。

该技能以 API 优先（Vapi REST）方式实现，并可选集成 Vapi CLI，用于 MCP 文档生成或本地工作流。

支持的功能

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

必需的密钥（secrets）

请设置以下任一密钥：

• VAPI_API_KEY（推荐）—— Vapi 控制台 API 密钥。

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

• 作为 Gateway 密钥 / 环境变量存储（首选），或
• 在运行辅助脚本前，在 shell 中执行 export 命令导出该密钥。

切勿将密钥粘贴至公开日志中。

端点（Endpoints）

基础 URL：

• https://api.vapi.ai

认证方式：

• Authorization: Bearer $VAPI_API_KEY

API 参考文档：

• https://api.vapi.ai/api（Swagger）

工具选项

本技能同时支持以下两种方式；您可在具体部署时再决定采用哪一种。

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

选项 A —— 通过辅助脚本调用 REST（全平台兼容）

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

• 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 方式。

文档：

• https://docs.vapi.ai/cli
• https://github.com/VapiAI/cli

安装：

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

选项 C —— MCP 文档服务器（提升 IDE 辅助能力）

该功能可增强 Cursor / Windsurf / VSCode 等 IDE 的开发体验：

• https://docs.vapi.ai/cli/mcp

vapi mcp setup

Agent 使用建议

当用户提出涉及 Vapi 的变更请求时，请按以下步骤操作：

1. 明确 操作范围：是针对助手、电话号码、Webhook，还是工具调用？
2. 优先执行 只读查询（如 list / get），确认状态后再进行破坏性操作。
3. 创建助手时，请向用户确认以下信息：
   • 助手名称
   • 模型提供商 / 模型（model provider / model）
   • 语音提供商 / 语音 ID（voice provider / voice id）
   • 是否需启用工具 / 函数调用（tools / function calling）
   • Webhook URL（若需接收服务端事件）
4. 发起通话前，请确认：
   • 主叫（from）与被叫（to）号码
   • assistantId
   • 合规性要求（如录音政策、用户授权等）

本技能包含的文件

• 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