Agent Radio

What This Skill Does

Agent Radio is a powerful multimedia skill for OpenClaw that transforms your AI assistant into an intelligent internet radio tuner. Built by art-ps, this tool enables seamless streaming of internet radio stations directly from your command-line environment. It integrates with industry-standard playback engines like mpv and ffplay to ensure high-fidelity audio output with automatic device detection across macOS, Linux, and Windows. Beyond simple playback, the skill offers a robust feature set for managing your listening experience, including a persistent database of favorite stations, volume management, playback control, and a live search interface to the massive Radio Browser directory.

Installation

To install this skill, run the command clawhub install openclaw/skills/skills/art-ps/agent-radio. Ensure that your environment has mpv and ffmpeg installed. On macOS, you can use Homebrew: brew install mpv ffmpeg. The skill is designed to handle audio device selection automatically; however, if you encounter issues, verify that your system paths for media binaries are configured correctly.

Use Cases

Use Agent Radio when you need background music for productivity or a quick way to tune into global broadcasts. It is ideal for users who want to switch between curated playlists, specific news streams, or genre-based web radio without leaving the terminal. It is especially useful for managing a 'favorites' list, allowing you to cycle through your top stations using simple commands like 'next' or 'play'. Developers can also use the 'find' feature to dynamically discover new content via the Radio Browser database.

Example Prompts

1. "OpenClaw, play some jazz music from my favorites list at volume 50."
2. "Search for a Lofi hip hop station and start playing the first result."
3. "Stop the current radio stream and tell me what the volume level is set to."

Tips & Limitations

Persistence is a key feature; the skill remembers your last station and volume level across sessions, ensuring you don't have to reconfigure every time you launch OpenClaw. If the radio fails to play, check your system's output device settings or ensure mpv is correctly installed in your PATH. The skill performs best with steady internet connections. Remember that the 'next' command cycles through your favorites list, making it perfect for quick browsing. Always use double quotes for station names that contain spaces or special characters to ensure proper command parsing.