openclaw-phone-receipt

📞 任务状态智能电话通知助手

基于 ElevenLabs+Twilio 技术栈的电话回执系统,在任务失败或标记紧急时自动外呼通知,确保用户离线也能及时掌握关键任务状态。

收藏
5.2k
安装
1.2k
版本
v1.0.1
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

OpenClaw Phone Receipt 是一款专为 OpenClaw 生态设计的智能通知技能,通过集成 ElevenLabs 语音合成与 Twilio 电话服务,为用户提供任务完成状态的电话回执能力。该技能的核心价值在于填补了纯文本通知的盲区——当用户处于离线状态或需要立即知晓任务失败时,系统自动触发语音电话通知,确保关键信息及时触达。

核心用法方面,用户可通过简单的命令 phone-receipt=on/off 启用或禁用电话回执策略,系统会将配置持久化到本地 memory/phone-receipt-state.json 文件。默认策略采用智能路由机制:仅在任务失败或用户明确标记为紧急(urgent/high-priority)时触发电话呼叫,而常规成功任务则通过 Telegram 发送文本摘要,避免不必要的电话打扰。对于希望立即验证配置的用户,可运行 scripts/trigger_call.sh 进行实时通话测试。整个流程需要配置 .env.elevenlabs-call 文件,包含 ElevenLabs Agent ID、Outbound Phone ID 及目标号码等必要参数。

显著优点体现在其智能化的通知策略与多渠道协同能力。首先,差异化通知逻辑(失败/紧急才打电话)既保证了关键事件的强提醒,又避免了成功任务的电话骚扰,用户体验更为精细。其次,技术栈选型成熟可靠,ElevenLabs 提供高质量的 AI 语音合成,Twilio 保障全球电话网络的稳定送达。此外,状态持久化机制允许跨会话保持用户偏好,无需每次重复配置。对于长期运行的自动化任务,该技能提供了可靠的"最后一公里"通知保障。

潜在缺点与局限性主要包括外部服务依赖与配置门槛。用户必须拥有 ElevenLabs 和 Twilio 的有效账号,并完成电话号码购买、验证等前置步骤,这对非技术用户存在一定门槛。Twilio 试用账号还存在目标号码必须预先验证的限制,可能影响快速上手。此外,电话呼叫会产生实际的 API 费用(按分钟计费),高频使用场景下成本需纳入考量。技能本身仅支持简单的开关策略,缺乏复杂的条件路由(如按时间段、按任务类型细分通知方式)等高级功能。

适合的目标群体主要是 OpenClaw 的重度用户,特别是那些运行关键后台任务(如数据备份、批处理作业、监控告警)且需要立即知晓失败状态的开发者与运维人员。对于经常离开电脑但又需要掌握任务状态的用户(如外勤人员、实验室环境),电话通知比纯文本消息更具穿透力。同时,已拥有 ElevenLabs/Twilio 账号的企业用户可快速集成该技能到现有工作流中,无需额外基础设施投入。

使用风险需关注隐私与合规、成本控制及服务稳定性三方面。隐私层面,用户需在本地存储 API Key 和电话号码等敏感信息,尽管 Skill 本身不收集数据,但 .env 文件的安全保管责任在用户侧,建议使用 chmod 600 限制文件访问权限。成本层面,国际电话费用可能较高,需在 Twilio/ElevenLabs 控制台设置消费限额防止意外超支。技术风险包括:Twilio 账号试用期限制可能导致呼叫失败;ElevenLabs API 的 convai_read 权限范围必须正确配置;网络波动可能影响 API 调用成功率。此外,作为 T3 来源的个人开发者作品,企业生产环境建议进行额外的代码审计与供应链安全评估。

安全解读

核心用法

OpenClaw Phone Receipt 是一个自动化电话回执管理工具,集成 ElevenLabs ConvAI 与 Twilio 服务,为任务执行结果提供语音通知能力。

主要功能场景

  • 任务失败自动触发电话回执(默认开启)
  • 紧急任务标记后强制电话通知
  • 任务成功时仅发送 Telegram 文本摘要(减少打扰)
  • 支持通过 phone-receipt=on/off 命令快速开关
  • 提供即时测试通话功能

配置管理
状态持久化存储于 memory/phone-receipt-state.json,包含 enabled 总开关及三项策略参数(onComplete/onFailure/onUrgent)。默认策略为失败/紧急时电话通知,普通成功任务仅走消息渠道。

技术实现

  • 状态切换脚本:set_phone_receipt_state.py on|off
  • 即时拨号脚本:trigger_call.sh
  • 依赖环境变量:ElevenLabs Agent ID、Outbound Phone ID、目标号码

显著优点

1. 智能降噪策略:区别于全量电话轰炸,采用「失败+紧急」双触发机制,平衡通知可靠性与用户打扰程度
2. 双通道冗余:电话与 Telegram 消息并行,网络异常时保有文字备份

3. 配置即代码:状态文件与命令行工具设计,便于版本管理与自动化集成

4. 零第三方依赖:纯 Python 标准库 + Bash 实现,部署轻量可控

潜在缺点与局限性

1. 来源可信度 T3:个人开发者维护(tuofangzhe),无企业背书,需自行评估长期维护风险
2. 电话号码无校验:直接透传 TO_NUMBER 环境变量,格式错误将导致 API 调用失败

3. 无重试机制:API 调用失败后直接退出,网络抖动场景可靠性不足

4. Twilio 门槛:需完成号码购买、验证等配置,新手 setup 成本较高

适合人群

  • 运行 OpenClaw 自动化任务的开发者/DevOps
  • 需要「关键失败必达」告警的生产环境运维
  • 已具备 ElevenLabs/Twilio 账户的语音服务用户
  • 追求「非紧急不打扰」通知体验的自动化爱好者

常规风险

  • API 密钥泄露:ELEVEN_API_KEY 需妥善保管,建议通过环境变量注入而非文件存储
  • Twilio 费用失控:未设置调用频次上限,高频失败场景可能产生意外账单
  • 隐私合规边界:电话回执涉及用户号码存储,需确保符合本地电信法规
  • 服务依赖单点:ElevenLabs 或 Twilio 服务中断将直接导致通知失效

openclaw-phone-receipt 内容

references文件夹
scripts文件夹
手动下载zip · 5.4 kB
env-example.txttext/plain
请选择文件