用途
voice-call 是 OpenClaw 的语音呼叫插件,用于发起或检查语音通话。它既可以作为命令行工具使用,也可以作为工具供智能体(agent)调用,实现由智能体主动发起的电话交互。
主要能力
- 发起呼叫与查询通话状态。
- 支持多种运营商:Twilio、Telnyx、Plivo,以及无需网络的 mock 模式。
- 作为工具提供以下动作:
- initiate_call (message, to?, mode?)
- continue_call (callId, message)
- speak_to_user (callId, message)
- end_call (callId)
- get_status (callId)
使用方式
命令行:
openclaw voicecall call --to "+15555550123" --message "Hello from OpenClaw"
openclaw voicecall status --call-id <id>
工具调用:
智能体发起呼叫时使用 voice_call,并通过上述动作进行发起、继续、语音播报、结束与状态查询。
配置说明:
- 需要启用 voice-call 插件。
- 插件配置位于 plugins.entries.voice-call.config。
- Twilio:provider: "twilio",并配置 twilio.accountSid / authToken 与 fromNumber。
- Telnyx:provider: "telnyx",并配置 telnyx.apiKey / connectionId 与 fromNumber。
- Plivo:provider: "plivo",并配置 plivo.authId / authToken 与 fromNumber。
- 开发回退:provider: "mock"(不使用网络)。
适用场景
适合需要通过电话渠道与用户进行语音交互的场景,例如智能体主动外呼、在通话中继续对话或向用户播报信息,以及查询某次通话的状态。
限制
- 使用前必须启用 voice-call 插件。
- 需要配置所选运营商对应的凭证与主叫号码(fromNumber)。
- 除 mock 模式外,其余运营商依赖网络与第三方服务。
- 关于计费、价格、通话质量或具体平台支持范围等信息,资料中暂未提供。