核心用法
media-orchestrator 作为 OpenClaw 生态的媒体中枢，提供端到端的媒体处理流水线：
1. 智能解析：调用 yt-dlp 的 ytsearch1: 语法，从 YouTube 精准匹配最高质量音/视频资源
2. 本地下载：自动拉取内容至工作区（.mp4 / .mp3），支持指定分辨率（如 480p）
3. 静默投递：通过 message 工具的 filePath 参数，向 WhatsApp/Telegram 发送文件，符合平台协议的无感知传输
4. Spotify 桥接：对 Spotify 请求，采用 Zero-Auth 元数据抓取（绕过官方 API 限制），生成 JSON 合约持久化至 /media/spotify/，供 WebUI 同步播放
显著优点
- 统一入口：单一 skill 覆盖 YouTube 下载 + Spotify 元数据双场景，减少用户认知成本
- 零授权设计：Spotify 零鉴权抓取避免 token 管理复杂度和速率限制
- 协议合规：文件投递严格遵循平台静默传输规范，降低封号风险
- 工作区隔离：媒体文件、元数据、脚本分层存储，便于清理和审计
潜在局限
- yt-dlp 依赖：受 YouTube 反爬策略波动影响，存在解析失败或速率受限可能
- Zero-Auth 脆弱性：Spotify 前端结构变更可能导致元数据抓取失效，需持续维护选择器
- 存储膨胀：下载文件暂存工作区，长期运行需配合清理策略
- 版权风险：下载受版权保护内容可能触发平台或法律层面的合规问题
适合人群
- 运营自动化场景（社群媒体分发）
- 自建流媒体聚合器的开发者
- 需要离线缓存 + 跨平台同步的个人用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 版权合规 | 下载行为可能违反 YouTube/Spotify ToS 及当地版权法 |
| 账号安全 | 高频下载可能触发平台反垃圾机制 |
| 供应链 | yt-dlp 更新滞后或恶意版本注入 |
| 数据残留 | 敏感元数据 JSON 未加密持久化 |