本页内容

本页内容

插件指南

语音通话插件

通过插件为 OpenClaw 提供语音通话:外呼通知、多轮对话、全双工实时语音、流式转录,以及带有允许列表策略的来电。

提供商: mock(开发环境,无网络)、plivo(语音 API + XML 转接 + GetInput 语音)、telnyx(Call Control v2)、twilio(可编程语音 + Media Streams)。

快速开始

  • 安装插件

    来自 npm

    bash
    openclaw plugins install @openclaw/voice-call

    从本地文件夹 (dev)

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

    使用裸包遵循当前版本标签。仅当您需要可重复安装时才固定确切版本。检查安装的应用结果;请参阅 应用更改并检查 。

  • 配置提供者和 webhook

    在 plugins.entries.voice-call.config 下设置配置(参见 Configuration)。至少:provider、提供商凭据、fromNumber 和可公开访问的 Webhook URL。对于多个座席,还要将 agentId 设置为应拥有呼叫的座席。

    对于入站 Twilio 号码,使用方法 POST 将其 Voice webhook 设置为公共语音呼叫 webhook URL。将号码级别的Status Callback设置为与?type=status相同的URL,同样使用POST,以便终端呼入呼叫状态到达插件。

  • 验证设置

    bash
    openclaw voicecall setupopenclaw voicecall setup --json

    检查插件启用、提供商凭据、Webhook 暴露、代理所有权,以及是否只有一种音频模式(streaming 或 realtime)处于活动状态。

  • 冒烟测试

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

    默认情况下两者都是试运行。添加 --yes 可发起一通简短的外呼通知电话:

    bash
    openclaw voicecall smoke --to "+15555550123" --yes
  • 各部分移动的地方

    单页版本的每个部分现在都位于此页面或下面的五个子页面之一上。单页版本中的锚点仍然在这里解析。

    语音通话配置

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

    语音通话实时和流媒体

    语音呼叫实时和流媒体 — 全双工实时语音、挂机检测、工具和咨询策略、座席语音上下文和 Twilio 媒体流转录。

    语音呼叫 TTS 和呼入呼叫

    语音呼叫 TTS 和入站呼叫 — 电话文本转语音、入站策略和按号码路由、语音输出合同、对话启动和过时呼叫收割机。

    语音通话安全和接口

    语音呼叫安全性和接口 — Webhook 签名和转发标头安全性,以及 CLI、代理工具和网关 RPC 表面。

    语音通话故障排除

    语音呼叫故障排除 — 修复了设置、Webhook 暴露、凭据、签名验证、Google Meet 拨入和静默实时呼叫。

    相关内容

    本页有帮助吗?