A local network controller for Roku devices that enables app launching, playback management, and menu navigation through the External Control Protocol.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install roku-control
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install roku-control using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Roku Control?
The Roku Control skill provides a direct interface between AI agents and Roku streaming hardware using the External Control Protocol (ECP). By operating entirely over the local area network, this addition to your Openclaw Skills library eliminates the need for cloud authentication, third-party accounts, or complex API configurations. It allows for near-instant execution of commands ranging from simple volume adjustments to complex text-based searches.
This skill is designed for developers who want to integrate home entertainment into their automated workflows. By leveraging the power of Openclaw Skills, you can transform your Roku device into a programmable component of a larger smart home ecosystem, enabling seamless transitions between different media applications and system states.
Roku Control Use Cases
- Automating the launch of specific streaming services like Netflix or Disney+ using friendly names.
- Implementing hands-free playback control including play, pause, and instant replay functions.
- Simplifying search workflows by sending full text strings instead of manual on-screen keyboard navigation.
- Coordinating multi-room setups by targeting specific Roku devices by their assigned friendly names in a JSON configuration.
- Creating comprehensive 'Movie Night' routines that synchronize device power, volume, and app state.
How Roku Control Works
- The skill initiates device discovery using SSDP (Simple Service Discovery Protocol) to locate Roku hardware on the same subnet as the Openclaw Skills environment.
- Once the target IP address is identified or manually configured, the skill formats commands as HTTP POST requests following the Roku ECP specification.
- Commands are transmitted directly to the device on port 8060, covering keypress emulation, app launching, or active app queries.
- The Roku device processes the local request immediately, providing a low-latency response that is reflected in the device's physical UI.
Roku Control Setup
First, identify the Roku devices available on your local network:
python3 scripts/roku_control.py discover
Once you have the IP address, verify the connection and retrieve device metadata:
python3 scripts/roku_control.py --ip 192.168.1.100 info
To make management easier within Openclaw Skills, map your devices in references/roku.json:
{
"living_room": {
"ip": "192.168.1.100",
"name": "Living Room TV"
}
}
Roku Control Data Schema & Taxonomy
The skill manages its environment through several reference files to ensure consistency across the Openclaw Skills ecosystem:
| File | Purpose |
|---|---|
references/roku.json |
Stores friendly names, IP addresses, and model metadata for multiple devices. |
references/common-apps.md |
A lookup table for App IDs (e.g., Netflix: 12, YouTube: 837). |
references/remote-keys.md |
A comprehensive list of supported ECP key strings for navigation and media control. |
Roku Control Advanced Features
- Support for deep linking and direct app launching via unique application IDs.
- Batch processing of commands with sleep intervals for complex UI navigation sequences.
- Full text input support to bypass character-by-character search limitations.
- Integration ready for cross-skill automation, allowing coordination with lighting or environmental controls within the Openclaw Skills framework.
- Automated discovery and health checks to handle dynamic IP assignments in non-static DHCP environments.
SKILL.md
Loading
Related Openclaw Skills
claw-shell
A terminal-focused skill that enables AI agents to run shell commands within a dedicated, persistent tmux session named claw.
ImagineAnything AI Social Network Skill
A comprehensive Openclaw Skills integration that gives AI agents a public social identity, messaging capabilities, and a marketplace for trading services.
Workspace Init
A foundational bootstrap skill for creating a standardized file structure and persistent identity for your AI agent.
Whale Watch - Crypto Whale Monitoring
A lightweight tool for tracking high-value cryptocurrency transactions and whale movements across multiple blockchains.
Publer Post
A powerful social media automation tool that allows AI agents to upload, schedule, and publish content across multiple platforms via the Publer API.
MCP Builder
A comprehensive framework for architecting robust Model Context Protocol servers that enable AI agents to interact seamlessly with external APIs and services.
Featured*
