语音助手构建器

构建、配置和管理语音AI助手。支持 Vapi（主要）、Bland.ai 和 Retell 平台。

快速开始

bash
export VAPIAPIKEY=your-vapi-api-key

创建语音助手

python3 {baseDir}/scripts/vapi_agent.py create-agent {name:销售助手,firstMessage:您好！今天有什么可以帮您的？,systemPrompt:您是Acme公司的销售助理。}

发起外呼

python3 {baseDir}/scripts/vapiagent.py call {assistantId:asstxxx,phoneNumberId:pn_xxx,customer:{number:+15551234567}}

列出助手

python3 {baseDir}/scripts/vapi_agent.py list-agents

列出通话记录

python3 {baseDir}/scripts/vapi_agent.py list-calls

平台对比

特性	Vapi	Bland.ai	Retell
最佳适用场景	自定义助手，开发者友好	简单外呼活动	企业级，低延迟
延迟

~800ms | ~500ms | ~500ms | | 语言支持 | 100+ | 30+ | 30+ | | 自定义LLM | ✅ 兼容任意OpenAI | ✅ 有限制 | ✅ 通过API | | 电话号码 | 购买/导入 | 购买/导入 | 购买/导入 | | 定价 | $0.05/分钟 + 供应商费用 | $0.09/分钟 全包 | $0.07-0.15/分钟 | | WebSocket | ✅ | ❌ | ✅ | | 知识库 | ✅ 内置 | ✅ | ✅ | | 转接 | ✅ | ✅ | ✅ |

推荐： 从 Vapi 开始——最灵活、文档最完善、社区最大。简单高量外呼使用 Bland。企业级低延迟需求使用 Retell。

详细对比见 {baseDir}/scripts/voice_comparison.md。

助手创建流程

1. 选择语音

Vapi支持多种TTS提供商：

• - ElevenLabs — 最佳质量，最自然（推荐）
• PlayHT — 质量不错，成本较低
• Deepgram — 快速，适合实时场景
• Azure — 企业级，多语言支持

2. 配置助手

json { name: 预约安排助手, firstMessage: 您好！我是史密斯医生办公室的莎拉。我打电话来帮您安排预约。, systemPrompt: 您是莎拉，一位友好的预约安排员..., voice: { provider: 11labs, voiceId: 21m00Tcm4TlvDq8ikWAM }, model: { provider: openai, model: gpt-4o, temperature: 0.7 }, endCallFunctionEnabled: true, maxDurationSeconds: 300, silenceTimeoutSeconds: 30 }

3. 语音提示工程

语音提示与文本提示不同。关键原则：

• - 保持回复简短 — 每次最多1-2句话
• 保持对话感 — 自然使用填充词（没问题！、明白了！）
• 处理打断 — 语音助手会被打断，为此设计
• 确认理解 — 重复关键信息（姓名、号码、日期）
• 包含回退机制 — 我没听清，能重复一下吗？

4. 电话号码设置

bash

列出可用电话号码

python3 {baseDir}/scripts/vapi_agent.py list-phones

购买号码（通过Vapi控制台或API）

导入现有号码（Twilio、Vonage）

python3 {baseDir}/scripts/vapi_agent.py import-phone {provider:twilio,number:+15551234567,twilioAccountSid:AC...,twilioAuthToken:...}

5. 通话处理

外呼：
bash
python3 {baseDir}/scripts/vapiagent.py call {assistantId:asstxxx,phoneNumberId:pn_xxx,customer:{number:+15551234567}}

呼入： 在Vapi控制台或通过API将助手分配给电话号码：
bash
python3 {baseDir}/scripts/vapiagent.py update-phone {id:pnxxx,assistantId:asst_xxx}

集成模式

语音 + CRM（GHL）

1. 1. 语音助手在通话中筛选潜在客户
2. 使用Vapi的serverUrl webhook捕获通话数据
3. 通话结束时 → 创建/更新GHL联系人
4. 将商机移至相应管道阶段
5. 如有需要安排跟进

语音 + 日历预约

1. 1. 助手通过日历API检查可用性
2. 使用函数调用预约
3. 口头确认日期/时间
4. 通话后发送短信确认

语音 + 知识库

上传文档到Vapi的知识库进行RAG： bash python3 {baseDir}/scripts/vapi_agent.py create-kb {name:产品FAQ,files:[faq.pdf]}

可用命令

bash
python3 {baseDir}/scripts/vapi_agent.py create-agent {...} # 创建新助手
python3 {baseDir}/scripts/vapi_agent.py get-agent # 获取助手详情
python3 {baseDir}/scripts/vapi_agent.py list-agents # 列出所有助手
python3 {baseDir}/scripts/vapi_agent.py update-agent {...} # 更新助手
python3 {baseDir}/scripts/vapi_agent.py delete-agent # 删除助手
python3 {baseDir}/scripts/vapi_agent.py call {...} # 发起外呼
python3 {baseDir}/scripts/vapi_agent.py get-call # 获取通话详情
python3 {baseDir}/scripts/vapi_agent.py list-calls # 列出所有通话
python3 {baseDir}/scripts/vapi_agent.py list-phones # 列出电话号码
python3 {baseDir}/scripts/vapi_agent.py import-phone {...} # 导入电话号码
python3 {baseDir}/scripts/vapi_agent.py update-phone {...} # 更新电话配置

致谢

由 M. Abidi 构建 | agxntsix.ai YouTube | GitHub 属于 OpenClaw 助手的 AgxntSix 技能套件 的一部分。

📅 需要为您的业务设置OpenClaw？ 预约免费咨询