plex

What This Skill Does

The plex skill enables your OpenClaw agent to act as a powerful interface for your Plex Media Server. By leveraging the Plex API, this skill allows the agent to communicate directly with your media library, effectively turning your AI into a personalized media center assistant. It provides the capability to query library sections, perform granular searches for specific media, track your "On Deck" watch history, and monitor active playback sessions across various devices. Whether you are managing your local server files or simply looking for the next episode of a series, the plex skill bridges the gap between your natural language requests and your media server's command-line API.

Installation

To integrate this functionality into your environment, run the command: clawhub install openclaw/skills/skills/dbhurley/plex. After installation, ensure you have configured your environment variables correctly. You will need to export your PLEX_SERVER URL (e.g., http://192.168.1.5:32400) and your PLEX_TOKEN. To acquire your token, sign in to your Plex account on their website, navigate to Authorized Devices, and inspect the XML link of your server to locate the key.

Use Cases

This skill is perfect for users who want to automate their media habits. You can use it to build "smart home" routines, such as asking the agent to show you what is currently playing on the living room TV. It is also excellent for library management, helping you quickly identify which sections are taking up space or tracking recently added content for new releases. If you are a developer, this skill can be used as a foundation for building more complex automation scripts or dashboards that monitor server health.

Example Prompts

1. "OpenClaw, check my Plex server and list all the shows currently in my TV library."
2. "What am I currently in the middle of watching on my Plex server?"
3. "Search my library for any movies directed by Christopher Nolan and list them for me."

Tips & Limitations

Note that the skill defaults to XML output from Plex, so always ensure the -H "Accept: application/json" header is utilized if you are extending the code. Library section keys are not universal and depend on your specific server architecture; always run a list command first to verify your section indices. For security, never hardcode your PLEX_TOKEN directly into scripts; use system environment variables instead. Finally, always confirm before initiating playback on a specific device to prevent accidental interruptions to ongoing sessions.