media-orchestrator
Unified skill for resolving, downloading, and delivering media (audio/video) to chat platforms.
Setup & Installation
Install command
clawhub install sieershafilone/media-orchestratorIf the CLI is not installed:
Install command
npx clawhub@latest install sieershafilone/media-orchestratorOr install with OpenClaw CLI:
Install command
openclaw skills install sieershafilone/media-orchestratoror paste the repo link into your assistant's chat
Install command
https://github.com/openclaw/skills/tree/main/skills/sieershafilone/media-orchestratorWhat This Skill Does
Handles media requests (audio, video, Spotify tracks) from chat platforms. Uses yt-dlp to search and download from YouTube, then delivers files to the requesting platform. For Spotify, it scrapes track metadata without API credentials and stores it as JSON for WebUI playback sync.
Combines YouTube search, download, and chat delivery into one step, and resolves Spotify metadata without requiring a Spotify API key.
When to Use It
- 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
View original SKILL.md file
# 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)
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Sending a song as an audio file through WhatsApp or Telegram
- 1Sending a song as an audio file through WhatsApp or Telegram
- 2Downloading and delivering a YouTube video at a specified resolution
- 3Triggering Spotify track playback from a chat message
- 4Syncing Spotify track metadata to the OpenClaw WebUI
- 5Handling both audio and video requests from a single chat interface
Unified skill for resolving, downloading, and delivering media (audio/video) to chat platforms.
Security Audits
These signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.