Voice Call

核心用法

voice-call 是 OpenClaw 框架的语音通话插件，提供 CLI 与 Tool 双模式调用能力，支持主流云通信服务商（Twilio、Telnyx、Plivo）及本地 Mock 模式。

CLI 操作：

• openclaw voicecall call —— 发起外呼，需指定目标号码 --to 与语音消息 --message
• openclaw voicecall status —— 查询指定通话 ID 的实时状态

Agent Tool 调用：

| 动作 | 用途 |

|------|------|

| `initiate_call` | 创建新通话，支持文本转语音消息 |

| `continue_call` | 向进行中的通话追加消息 |

| `speak_to_user` | 对指定通话播报内容 |

| `end_call` | 主动终止通话 |

| `get_status` | 获取通话状态详情 |

配置要求：
需在 plugins.entries.voice-call.enabled 开启后，于 plugins.entries.voice-call.config 中配置厂商凭证：

• Twilio: accountSid + authToken + fromNumber
• Telnyx: apiKey + connectionId + fromNumber
• Plivo: authId + authToken + fromNumber
• Mock: 开发测试模式，无实际网络请求

显著优点

1. 多厂商兼容：一次接入，灵活切换服务商，避免供应商锁定
2. 双接口设计：CLI 适合运维脚本与批量任务，Tool 接口便于 AI Agent 实时决策
3. 状态可观测：完整的通话生命周期管理，支持中断后恢复与状态追踪
4. 开发友好：Mock 模式实现零成本本地调试

潜在局限

• 依赖外部服务商：实际通话质量、费率、合规性受第三方厂商制约
• 配置复杂度：需管理多组 API 密钥与号码资源，密钥轮转需人工介入
• 无内置录音/ASR：纯语音播报能力，如需语音识别或录音需额外集成
• 地域合规风险：跨境外呼需自行确认目标国家电信法规（如美国 TCPA、欧盟 GDPR）

适合人群

• 构建 AI 外呼机器人、语音通知系统的开发者
• 需将语音能力嵌入自动化工作流的 DevOps/SRE 团队
• 希望避免自建语音基础设施的中小技术团队

常规风险

| 风险类别 | 说明 |

|----------|------|

| 凭证泄露 | API 密钥存储于配置文件，需配合密钥管理系统（KMS/Vault）使用 |

| 费用失控 | 误配置导致循环外呼或国际长途，建议启用厂商侧消费限额 |

| 滥用合规 | 未获授权的自动外呼可能违反反骚扰法规，需前置用户授权机制 |

| 服务可用性 | 依赖厂商网络，故障时需具备降级或熔断策略 |