ezviz-open-camera-broadcast
Best for Ezviz smart home usersWorks with GitHub
⌘source
- author
@LeoYeAI- language
- Python
★2kstars
306forks
May 6, 2026
✦overview.md
Key Features
- ·Upload or TTS audio to Ezviz devices
- ·Environment variable credential configuration
- ·Token caching with configurable path
- ·Supports local file or text-to-speech
- ·Reads credentials from config files as fallback
Use Cases
- →Send voice notifications to security cameras
- →Broadcast reminders through smart home devices
- →Integrate audio alerts into automation workflows
Best for
- ✓Ezviz smart home users
- ✓Automation pipelines with IoT devices
Not ideal for
- !Unsecured credential management
- !Systems without TTS dependencies
FAQs
name
ezviz-audio-broadcast
description
萤石语音广播技能。支持本地音频文件上传或文本转语音，实现语音内容下发到设备播放。
Use when: 需要向萤石设备发送语音通知、广播、提醒等音频内容。
⚠️ 安全要求：必须设置 EZVIZ_APP_KEY 和 EZVIZ_APP_SECRET 环境变量，使用最小权限凭证。
metadata:{"openclaw":{"emoji":"🔊","requires":{"env":["EZVIZ_APP_KEY","EZVIZ_APP_SECRET","EZVIZ_DEVICE_SERIAL"],"pip":["requests"]},"primaryEnv":"EZVIZ_APP_KEY","warnings":["Requires Ezviz credentials with minimal permissions","Token cached in system temp directory (configurable)","Uses system TTS commands (say/espeak/ffmpeg) via subprocess","May read ~/.openclaw/*.json for credentials (env vars have priority)"],"config":{"tokenCache":{"default":true,"envVar":"EZVIZ_TOKEN_CACHE","description":"Enable token caching (default: true). Set to 0 to disable.","path":"/tmp/ezviz_global_token_cache/global_token_cache.json","permissions":"0600"},"configFileRead":{"paths":["~/.openclaw/config.json","~/.openclaw/gateway/config.json","~/.openclaw/channels.json"],"priority":"lower than environment variables","description":"Reads Ezviz credentials from OpenClaw config files as fallback"}}}}
Ezviz Audio Broadcast (萤石语音广播)
通过萤石语音上传和下发接口，实现语音内容到设备的广播播放。
⚠️ 安全警告 (安装前必读)
在使用此技能前，请完成以下安全检查：
| # | 检查项 | 状态 | 说明 |
|---|---|---|---|
| 1 | 凭证权限 | ⚠️ 必需 | 使用最小权限的 AppKey/AppSecret，不要用主账号凭证 |
| 2 | 配置文件读取 | ⚠️ 注意 | 技能会读取 ~/.openclaw/*.json 文件（但环境变量优先级更高） |
| 3 | Token 缓存 | ⚠️ 注意 | Token 缓存在 /tmp/ezviz_global_token_cache/ (权限 600) |
| 4 | 系统命令 | ⚠️ 注意 | 使用 say/espeak/ffmpeg 进行 TTS (通过 subprocess) |
| 5 | API 域名 | ✅ 已验证 | openai.ys7.com 是萤石官方 API 端点（openai = Open API，不是 AI） |
| 6 | 代码审查 | ✅ 推荐 | 审查 scripts/audio_broadcast.py 和 lib/token_manager.py |
🔒 配置文件读取详细说明
凭证获取优先级（从高到低）：
┌─────────────────────────────────────────────────────────────┐
│ 1. 环境变量 (最高优先级 - 推荐) │
│ ├─ EZVIZ_APP_KEY │
│ ├─ EZVIZ_APP_SECRET │
│ └─ EZVIZ_DEVICE_SERIAL │
│ ✅ 优点：不读取配置文件，完全隔离 │
├─────────────────────────────────────────────────────────────┤
│ 2. OpenClaw 配置文件 (仅当环境变量未设置时使用) │
$install
1-click copynpx skills add LeoYeAI/openclaw-master-skills --skill ezviz-open-camera-broadcastSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.