本页内容
本页内容
插件指南
语音通话插件
通过插件为 OpenClaw 提供语音通话:外呼通知、多轮对话、全双工实时语音、流式转录,以及带有允许列表策略的来电。
提供商: mock(开发环境,无网络)、plivo(语音 API + XML 转接 + GetInput 语音)、telnyx(Call Control v2)、twilio(可编程语音 + Media Streams)。
快速开始
安装插件
来自 npm
从本地文件夹 (dev)
使用裸包遵循当前版本标签。仅当您需要可重复安装时才固定确切版本。检查安装的应用结果;请参阅 应用更改并检查 。
配置提供者和 webhook
在 plugins.entries.voice-call.config 下设置配置(参见 Configuration)。至少:provider、提供商凭据、fromNumber 和可公开访问的 Webhook URL。对于多个座席,还要将 agentId 设置为应拥有呼叫的座席。
对于入站 Twilio 号码,使用方法 POST 将其 Voice webhook 设置为公共语音呼叫 webhook URL。将号码级别的Status Callback设置为与?type=status相同的URL,同样使用POST,以便终端呼入呼叫状态到达插件。
验证设置
检查插件启用、提供商凭据、Webhook 暴露、代理所有权,以及是否只有一种音频模式(streaming 或 realtime)处于活动状态。
冒烟测试
默认情况下两者都是试运行。添加 --yes 可发起一通简短的外呼通知电话:
各部分移动的地方
单页版本的每个部分现在都位于此页面或下面的五个子页面之一上。单页版本中的锚点仍然在这里解析。
语音通话配置
语音呼叫配置 — 插件配置键、呼叫所有者、完整配置参考表和会话范围。
语音通话实时和流媒体
语音呼叫实时和流媒体 — 全双工实时语音、挂机检测、工具和咨询策略、座席语音上下文和 Twilio 媒体流转录。
语音呼叫 TTS 和呼入呼叫
语音呼叫 TTS 和入站呼叫 — 电话文本转语音、入站策略和按号码路由、语音输出合同、对话启动和过时呼叫收割机。
- TTS 用于通话
- TTS 示例
- 仅核心TTS
- 覆盖至 ElevenLabs(仅调用)
- OpenAI模型覆盖(深度合并)
- 呼入电话
- 按号码路由
- 语音输出合约
- 会话启动行为
- Twilio 流断开宽限
- 陈旧呼叫收割者
语音通话安全和接口
语音呼叫安全性和接口 — Webhook 签名和转发标头安全性,以及 CLI、代理工具和网关 RPC 表面。
- Webhook 安全
- webhookSecurity.allowedHosts
- webhookSecurity.trustForwardingHeaders
- webhookSecurity.trustedProxyIPs
- CLI
- 代理工具
- 网关 RPC
语音通话故障排除
语音呼叫故障排除 — 修复了设置、Webhook 暴露、凭据、签名验证、Google Meet 拨入和静默实时呼叫。
- 故障排除
- 呼叫放置无法保存其初始记录
- 安装失败 webhook 暴露
- 提供者凭据失败
- 呼叫开始但提供商 Webhooks 未到达
- 签名验证失败
- Google Meet Twilio 加入失败
- 实时通话无语音
相关内容
- 对话模式
- 文本转语音
- 语音唤醒
- Google Meet 插件 - Meet 通话,包括通过语音通话委托的 Twilio 会话
openclaw voicecall- 插件提供的CLI命令,仅在安装此插件时出现