萤石语音广播（Ezviz Audio Broadcast）是一个专为萤石智能设备设计的开源技能，用于实现向支持对讲功能的摄像头等设备发送语音通知、广播或提醒。该工具通过调用萤石开放平台（openai.ys7.com）的API接口，支持两种主要使用方式：上传本地音频文件或输入文本内容由系统自动转换为语音（TTS）后再下发播放。其核心优势在于自动化处理访问令牌（Token）获取与缓存机制，用户无需手动管理复杂的认证流程，只需提供AppKey和AppSecret即可快速部署使用。 为确保安全合规运行，该技能严格遵循最小权限原则，推荐使用环境变量配置凭证而非明文配置文件，并默认启用安全的Token缓存策略以提升效率。同时，代码层面已加入多重防护措施，包括输入验证、危险字符拦截以及临时文件清理等，有效防范常见安全风险如命令注入。值得注意的是，所有API通信均直接发送至萤石官方域名，不会涉及第三方数据流转，保障了用户隐私与数据安全。 目前版本v1.0.5已全面披露技术细节与安全审计结果，涵盖凭证优先级、缓存行为、系统依赖及网络端点等信息，适用于需要远程语音交互的各类物联网场景，如家庭安防提醒、办公区域通知、商业场所广播乃至工业环境警示等。开发者可在隔离环境中先行测试，再根据实际需求调整参数完成集成。
核心功能特点
- 支持本地音频文件上传或文本转语音（TTS）生成音频后下发播放
- 自动获取并缓存访问令牌（Token），有效期7天，到期前自动刷新
- 采用环境变量优先的凭证管理机制，避免敏感信息泄露风险
- 内置输入验证与危险字符过滤，防止命令注入攻击
- 兼容多设备批量操作，支持指定通道号与混合格式设备列表
- 默认启用全局Token缓存，提升重复调用效率，也可按需禁用
适用场景
萤石语音广播技能特别适合需要向多个智能摄像头同步发送语音信息的实际应用场景。例如，在家庭安防系统中，当检测到异常活动时，可通过该工具迅速向门口监控设备播放‘请注意，有陌生人靠近’的安全提示；在办公室环境中，可用于定时播报会议提醒或访客接待通知，增强沟通效率。对于零售店铺而言，结合排队叫号系统可实现促销信息的多点位广播，提升客户体验与销售转化率。 更广泛地看，该工具也适用于工厂车间、仓库管理或公共场所等工业与商业领域。比如生产线上的操作员可通过语音指令接收任务更新，而管理人员则能在紧急情况下发布疏散指引或安全警告。由于支持文本转语音功能，用户甚至可以在不准备音频素材的情况下即时生成个性化播报内容，极大提升了灵活性与响应速度。 此外，考虑到不同部署环境的差异性，该技能提供了丰富的配置选项以满足多样化需求。无论是单机个人项目还是企业级的分布式系统，均可通过设置环境变量、命令行参数或OpenClaw配置文件灵活接入，确保在不同安全等级和网络条件下稳定运行。