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)