vapi-skill

Vapi Skill 是 OpenClaw 平台专为 Vapi.ai 语音云服务设计的管理工具，提供从语音代理创建到呼叫管理的全栈 API 能力。该技能采用 API-first 架构，支持通过 REST 接口、Vapi CLI 或 MCP 文档服务器三种模式与 Vapi 平台交互，使开发者能够在 OpenClaw 代理中直接管理 assistants、phone numbers、tools 和 webhooks。

核心用法涵盖五大维度：创建与配置语音助手（支持 OpenAI、ElevenLabs 等主流模型与语音提供商）、发起与监控呼叫会话、管理电话号码资源、配置函数调用工具以及设置 webhook 事件回调。用户可通过 Node.js 辅助脚本直接调用 REST API，或选择安装 Vapi CLI 进行交互式操作，亦可通过 MCP 服务器获得 IDE 智能提示。

显著优点在于其架构的灵活性与功能的完整性。作为纯文档型技能，它无需本地依赖即可工作，同时提供多层级接入方案适应不同场景——快速集成选择 REST，本地调试使用 CLI，开发辅助采用 MCP。功能覆盖 Vapi 全生态，支持复杂的语音 AI 工作流编排，且明确遵循安全最佳实践，要求通过环境变量或 Gateway 密钥管理服务提供 API 认证。

潜在局限性主要体现在外部依赖与操作风险上。该技能深度依赖 Vapi 云服务（api.vapi.ai）的可用性，网络中断或服务端故障将直接影响功能。CLI 安装过程采用 curl | bash 模式且缺乏完整性校验，存在供应链攻击面。此外，文档中引用的 Node 辅助脚本（vapi-api.mjs）实际未包含在技能包中，可能导致用户困惑。

适合的目标群体包括：需要集成语音 AI 能力的全栈开发者、构建智能客服系统的企业技术团队、以及使用 OpenClaw 平台编排复杂呼叫工作流的自动化工程师。对于希望将 GPT-4 等大模型与语音交互结合，且已采用 Vapi 作为语音基础设施的团队尤为适用。

使用该技能需关注三类常规风险：首先是 API 密钥安全，尽管文档明确要求通过安全渠道配置 VAPI_API_KEY，但用户若误将密钥硬编码或泄露至日志仍会导致未授权访问；其次是网络传输安全，所有请求均发送至第三方 Vapi 服务器，敏感通话数据可能经过外部基础设施；最后是操作风险，技能支持创建呼叫等付费操作，误配置可能导致意外账单，尽管文档建议优先只读查询，但缺乏强制的操作确认机制。