openclaw-phone-receipt

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

🥥71总安装量 16评分人数 16
100% 的用户推荐

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

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范,无 eval/exec/system 等危险函数,通过静态安全检查
  • ✅ 输入验证完善,Python 脚本严格校验 on/off 参数,无注入风险
  • ✅ 依赖纯净,仅使用 Python 标准库和系统 curl 工具,无第三方包风险
  • ⚠️ 需配置敏感凭证(ElevenLabs API Key、电话号码),建议设置文件权限为 600
  • ⚠️ 来源为 GitHub 个人账号(T3),虽通过 A 级认证,建议企业用户额外审计

使用说明

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 内容

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