OpenClaw Phone Receipt

通过ElevenLabs+Twilio触发和管理OpenClaw外呼电话通知,用于任务完成/失败提醒。适用于:用户请求完成任务后拨打其电话、启用/禁用电话收据开关("phone-receipt=on/off")、测试通话质量,或在会话间保持电话收据设置。

安装

概览

OpenClaw Phone Receipt 是一个专为自动化外呼通知设计的技能模块,通过集成 ElevenLabs 的语音合成与 Twilio 的电话通信能力,实现任务完成或失败后的智能电话回调提醒。该工具的核心机制在于根据用户指令动态管理电话收据策略,支持在会话中启用或禁用电话通知功能,并持久化保存当前设置状态。默认情况下,系统仅在任务失败、标记为紧急,或用户明确请求回调时触发实际电话呼叫;其余情况则通过 Telegram 文本消息提供摘要反馈,从而平衡信息及时性与通信成本。整个流程由简单的命令行指令控制,便于开发者快速部署和测试。 该技能依赖于外部服务配置,主要包括 ElevenLabs 提供的 AI 语音代理(Agent)和出站电话号码资源,以及 Twilio 账户用于实际的语音通话连接。为确保稳定运行,需正确设置 `.env.elevenlabs-call` 环境文件,包含必要的 API 密钥、代理 ID 和目标号码等参数。若调用过程中出现错误,系统会返回简明的原因诊断,例如目标号码未经验证(Twilio 试用限制)、缺少 ConvAI 权限范围,或关键 ID 缺失等问题,帮助使用者快速定位故障点。此外,还支持手动触发即时测试通话,方便调试与验证整体链路是否正常工作。 作为 OpenClaw 生态的一部分,此模块遵循标准化的发布规范,其版本信息、变更日志及文件大小均需符合 ClawHub 平台的上架要求。完整的技术文档涵盖从账号注册、API 权限申请到最终集成的详细步骤,并提供了常见问题排查指南,降低初次使用者的入门门槛。无论是日常运维监控还是高优先级事件告警,OpenClaw Phone Receipt 都能以轻量级方式增强系统的可观测性和用户体验。

核心功能特点

  1. 支持通过 ‘phone-receipt=on/off’ 指令动态切换电话收据开关状态
  2. 默认仅在任务失败、标记为紧急或用户主动请求时触发真实电话呼叫
  3. 非紧急成功任务自动转为 Telegram 文本摘要发送,节省通信资源
  4. 状态持久化存储于 memory/phone-receipt-state.json 文件中
  5. 内置脚本支持手动触发测试通话及批量修改策略
  6. 完善的错误处理机制,返回具体失败原因与后续操作建议

适用场景

OpenClaw Phone Receipt 特别适用于需要实时反馈但又不希望频繁打扰用户的自动化场景。例如,在一个后台数据处理系统中,当某个批处理作业意外中断时,管理员无需时刻盯着控制台,只需依赖该技能自动拨打预设的管理员手机,用自然语音告知故障详情及建议操作路径,极大提升响应效率。同样地,对于电商平台中的订单履约流程,若物流信息更新延迟超过阈值,可结合紧急标记机制立即发起电话通知,确保客户第一时间获知异常情况。 另一个典型应用场景是远程设备监控系统。物联网终端可能分布在偏远地区,网络条件不稳定,短信或邮件容易被忽略。此时启用电话收据功能后,一旦传感器检测到温度超标或断电事件,系统便会主动呼叫负责人,利用语音传递关键警报内容,比文字更具紧迫感。而对于常规状态报告——比如服务器每日备份顺利完成——则统一采用 Telegram 消息推送,既保证了信息可达性又避免了不必要的通话费用。 在企业内部协作工具中,该技能也可用于审批流程提醒。当员工提交请假申请进入待审阶段,若长时间无响应,可将其标记为‘urgent’,触发电话回访确认优先级;反之,普通事务则保持静默处理模式。这种灵活的策略分级设计,使得同一套基础设施既能满足紧急响应需求,又能适应日常运营节奏,真正实现智能化分层通知体系。