Roku Control

Control Roku devices over your local network using the External Control Protocol (ECP). No authentication, cloud services, or complex setup required - just local HTTP commands.

Prerequisites

• - Roku device on the same network as OpenClaw
• Roku's IP address (can be discovered automatically)

Setup (First Time)

1. Discover your Roku:

CODEBLOCK0

This will show all Roku devices on your network with their IP addresses.

2. Save the IP address:

Note your Roku's IP (e.g., 192.168.1.100) for use in commands.

3. Test connectivity:

CODEBLOCK1

Common Operations

Device Information

CODEBLOCK2

Navigation & Control

CODEBLOCK3

Playback

CODEBLOCK4

Volume & Power

CODEBLOCK5

Launch Apps

CODEBLOCK6

Search & Text Input

CODEBLOCK7

Natural Language Translation

Map user requests to commands:

Navigation:

• - "Go to home screen" → INLINECODE1
• "Go back" → INLINECODE2
• "Scroll down" / "Move down" → INLINECODE3
• "Select this" / "Click" → INLINECODE4

Playback:

• - "Play" / "Resume" → INLINECODE5
• "Pause" → INLINECODE6
• "Rewind" → INLINECODE7
• "Fast forward" → INLINECODE8
• "Go back 10 seconds" / "Replay that" → INLINECODE9

Volume:

• - "Turn up the volume" → INLINECODE10
• "Turn down the volume" → INLINECODE11
• "Mute" / "Unmute" → INLINECODE12

Apps:

• - "Open Netflix" → INLINECODE13
• "Launch YouTube" → INLINECODE14
• "Start Hulu" → INLINECODE15

Search:

• - "Search for Breaking Bad" → INLINECODE16
• "Find Stranger Things" → Open search + send text

Power:

• - "Turn off the TV" → INLINECODE17

Common App IDs

See references/common-apps.md for a comprehensive list.

Quick reference:

• - Netflix: 12
• YouTube: 837
• Hulu: 2285
• Disney+: 291097
• Amazon Prime Video: 13
• HBO Max: 61322
• The Roku Channel: 151908

To get app IDs for your specific Roku:
CODEBLOCK8

Complete Key Reference

See references/remote-keys.md for all supported remote keys.

Common keys: Home, Back, Up, Down, Left, Right, Select, Play, Pause, Rev, Fwd, VolumeUp, VolumeDown, VolumeMute, PowerOff, Search, INLINECODE34

Advanced Workflows

Watch Netflix

CODEBLOCK9

Search and Play

CODEBLOCK10

Quick Replay

CODEBLOCK11

Movie Night Setup

CODEBLOCK12

Device Mapping

Store your Roku IP in references/roku.json:

CODEBLOCK13

Then reference by friendly name in conversations.

Troubleshooting

"No Roku devices found"

• - Ensure Roku is powered on and connected to network
• Check that OpenClaw and Roku are on same network/subnet
• Some routers block SSDP discovery - try manual IP if known
• Verify Roku's network settings in Settings → Network

"Connection timeout"

• - Verify IP address is correct
• Ping the Roku: INLINECODE36
• Check firewall isn't blocking port 8060
• Roku may have changed IP (use DHCP reservation)

"Key not working"

• - Some keys only work on Roku TVs (volume, power, inputs)
• Volume keys require HDMI-CEC or Roku TV
• Power commands may not be supported on older devices
• Check references/remote-keys.md for compatibility

App won't launch

• - Verify app is installed: run apps command
• Use correct app ID (case-sensitive for name matching)
• Some apps require additional authentication in their own UI

Discovery not finding device

• - Try manual IP if you know it: check router DHCP leases
• Roku's IP is shown in Settings → Network → About
• Set static IP or DHCP reservation for reliability

Integration with Other Skills

Movie Night Routine

Combine with Govee lights skill:

CODEBLOCK14

Notes

• - ECP protocol works entirely over LAN (no internet required)
• No authentication or API keys needed
• Commands are instant (local network speed)
• Multiple Roku devices can be controlled independently
• Works with Roku TVs, streaming sticks, and boxes
• Power-on commands not supported (ECP limitation - Roku must be awake)
• For power-on, use HDMI-CEC or network wake features if available

Limitations

• - Cannot power on a fully-off Roku (ECP only works when device is on)
• Volume/power commands limited to Roku TVs or HDMI-CEC setups
• No feedback on success/failure for some commands
• Text input is character-by-character (slower for long searches)
• Discovery requires SSDP (some networks block multicast)