Vapi AI_AI Agent skill-PHP中文网

Vapi AI

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过 Vapi REST API 或 CLI 管理 Vapi 语音助手、通话、电话号码、工具和 Webhook，以实现语音代理操作与集成。

Vapi (vapi.ai) – OpenClaw Skill. 当您需要管理 OpenClaw 代理商的Vapi 语音代理( 助手) 、电话、电话号码、

功能概述

Vapi (vapi.ai) – OpenClaw Skill. 当您需要管理 OpenClaw 代理商的Vapi 语音代理( 助手) 、电话、电话号码、是一项面向实际任务的技能，主要用于此技能是 API- first。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

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 的变更请求时，请按以下步骤操作：

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