OpenClaw · Skill
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.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install sieershafilone/media-orchestratorClawHub installer
npx clawhub@latest install sieershafilone/media-orchestratorOpenClaw CLI
openclaw skills install sieershafilone/media-orchestratorDirect OpenClaw install
openclaw install sieershafilone/media-orchestratorWhat this skill does
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.
Why it matters
Combines YouTube search, download, and chat delivery into one step, and resolves Spotify metadata without requiring a Spotify API key.
Typical use cases
- Sending a song as an audio file through WhatsApp or Telegram
- Downloading and delivering a YouTube video at a specified resolution
- Triggering Spotify track playback from a chat message
- Syncing Spotify track metadata to the OpenClaw WebUI
- Handling both audio and video requests from a single chat interface
Source instructions
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
- Resolution: Upon receiving a media request, the orchestrator uses
yt-dlp'sytsearch1:functionality to find the highest quality match from YouTube. - Download: The selected media (audio or video) is downloaded directly into the OpenClaw workspace.
- Delivery: The downloaded file is then dispatched to the requesting chat platform (WhatsApp/Telegram) using the
messagetool'sfilePathargument, ensuring silent delivery as per protocol. - 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 thespotify-surfacecomponent.
- Stores Spotify track contracts (e.g.,
- 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)