Media Orchestrator

---

name: media-orchestrator description: Unified skill for resolving, downloading, and delivering media (audio/video) to chat platforms. Integrates yt-dlp for resolution and handles Spotify metadata sync.

---

Media Orchestrator

This skill centralizes the logic for handling all media requests (audio, video, Spotify tracks) from chat platforms like WhatsApp and Telegram. It leverages yt-dlp for robust search and download capabilities from YouTube and performs Spotify metadata resolution for WebUI integration.

⚙️ How it Works

1. Resolution: Upon receiving a media request, the orchestrator uses yt-dlp's ytsearch1: functionality to find the highest quality match from YouTube. 2. Download: The selected media (audio or video) is downloaded directly into the OpenClaw workspace. 3. Delivery: The downloaded file is then dispatched to the requesting chat platform (WhatsApp/Telegram) using the message tool's filePath argument, ensuring silent delivery as per protocol. 4. Spotify Sync: For Spotify-specific requests, the orchestrator resolves track metadata via Zero-Auth scraping (bypassing direct API holds) and persists this data as a JSON contract in the workspace, enabling synchronized playback in the OpenClaw WebUI.

📂 Workspace Paths

Primary Workspace: /home/ky11rie/.openclaw/workspace/

- Raw downloaded media files (.mp4, .mp3, etc.) reside here temporarily.

Spotify Metadata: /home/ky11rie/.openclaw/workspace/media/spotify/

- Stores Spotify track contracts (e.g., track_id.json) generated by the spotify-surface component.

Skill Scripts: /home/ky11rie/.openclaw/workspace/skills/spotify-surface/scripts/

- Contains the dedicated logic engine for Spotify integration.

🛠️ Commands

This skill acts as an underlying orchestrator, processing natural language requests. Example intents it handles:

send audio file song: [song name]

send video file mp4 480p: [video name]

play [spotify track or url] (leveraging spotify-surface)