跳转至

语音通话

通过插件为 OpenClaw 实现语音呼叫：呼出通知、多轮对话、全双工实时语音、流式转录，以及带允许列表策略的呼入呼叫。

供应商： mock（开发用，无网络）、plivo（语音 API + XML 转接 + GetInput 语音）、telnyx（呼叫控制 v2）、twilio（可编程语音 + 媒体流）。

Note

Voice Call 插件在 Gateway 进程内运行。如果你使用远程 Gateway，请在运行 Gateway 的机器上安装并配置该插件。安装会自动应用于正在运行的 Gateway；如果 Gateway 离线，请在配置完成后启动它。

快速开始

1. 安装插件

openclaw plugins install @openclaw/voice-call

PLUGIN_SRC=./path/to/local/voice-call-plugin
openclaw plugins install "$PLUGIN_SRC"
cd "$PLUGIN_SRC" && pnpm install

使用裸包以跟随当前发布标签。仅当你需要可重现的安装时，才锁定精确版本。检查安装的应用结果；参见应用更改并检查。

2. 配置供应商和 Webhook

在 plugins.entries.voice-call.config 下设置配置（参见配置）。至少需要：provider、供应商凭据、fromNumber，以及一个可公网访问的 Webhook URL。如果有多个 agent，还要将 agentId 设置为应拥有呼叫的 agent。

对于 Twilio 呼入号码，将其语音 Webhook设置为公网 Voice Call Webhook URL，方法为 POST。将号码级别的状态回调设置为相同的 URL，并附加 ?type=status，同样使用 POST，以便终态呼入呼叫状态能够到达插件。

3. 验证设置

openclaw voicecall setup
openclaw voicecall setup --json

检查插件是否启用、供应商凭据、Webhook 暴露情况、agent 归属，以及是否只有一个音频模式（streaming 或 realtime）处于激活状态。

4. 冒烟测试

openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123"

两者默认都是试运行。添加 --yes 可发起一次简短的呼出通知呼叫：

openclaw voicecall smoke --to "+15555550123" --yes

Warning

对于 Twilio、Telnyx 和 Plivo，设置必须解析为公网 Webhook URL。如果 publicUrl、隧道 URL、Tailscale URL 或 serve 回退解析到回环地址或私有网络空间，设置将失败，而不会启动一个无法接收运营商 webhook 的供应商。

各章节迁移位置

单页版本的每个章节现在都位于此页面或下方五个子页面之一。单页版本中的锚点仍然可以在此处解析。

语音呼叫配置

语音呼叫配置——插件配置键、呼叫所有者、完整配置参考表和会话范围。

语音呼叫实时与流式

语音呼叫实时与流式——全双工实时语音、挂断检测、工具与咨询策略、agent 语音上下文，以及 Twilio Media Streams 转录。

语音呼叫 TTS 与呼入呼叫

语音呼叫 TTS 与呼入呼叫——电话文本转语音、呼入策略与按号码路由、语音输出契约、对话启动，以及过期呼叫回收器。

语音通话安全与接口

语音通话安全与接口 — Webhook 签名和转发头安全，以及 CLI、Agent 工具和 Gateway RPC 接口。

语音通话故障排查

语音通话故障排查 — 针对设置、Webhook 暴露、凭据、签名验证、Google Meet 拨入以及静默实时通话的修复方法。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw