roku-control

Roku Control 是一款基于 Roku 官方 External Control Protocol (ECP) 的本地网络设备控制技能，允许用户通过简单的 HTTP 命令完全操控局域网内的 Roku 电视或流媒体播放器。

核心用法涵盖设备自动发现、应用启动、导航控制、媒体播放、音量调节及文本搜索六大类操作。用户可通过 SSDP 协议自动发现网络中的 Roku 设备，获取 IP 地址后，使用 CLI 命令或自然语言指令执行操作，如启动 Netflix、调节音量、发送搜索关键词等。技能支持复杂工作流编排，可结合睡眠延迟实现"电影之夜"等自动化场景，并能与其他智能家居技能（如灯光控制）联动。

显著优点包括：纯本地通信零延迟，无需互联网连接；零认证零配置，开箱即用；支持全面的遥控器功能模拟；提供完善的自然语言映射，降低使用门槛；完全隐私安全，无云端数据交互。

潜在局限性需留意：ECP 协议无法唤醒完全关机的设备；依赖稳定的本地网络环境，设备 IP 变动需重新配置；音量与电源控制仅限 Roku TV 或支持 HDMI-CEC 的 setup；文本输入采用逐字符发送方式，长文本搜索效率较低；部分路由器可能屏蔽 SSDP 多播发现。

适合拥有 Roku 设备的家庭用户、智能家居自动化爱好者及追求隐私安全的本地中控方案使用者。特别适合构建"一键观影"等家庭影院自动化场景。

使用风险主要涉及网络配置：需确保防火墙未阻断 8060 端口及 SSDP 多播；建议为 Roku 设备配置静态 IP 或 DHCP 保留以避免 IP 变动导致控制失效；依赖 requests 库建议升级至 2.25.0 以上版本以防范潜在安全漏洞。

核心用法

roku-control 是一款面向 OpenClaw 平台的本地网络 Roku 设备控制工具，通过 Roku 官方 ECP (External Control Protocol) 协议实现零配置、无认证的局域网遥控。用户只需确保设备与 Roku 处于同一网络，即可通过命令行或自然语言指令完成导航、播放控制、音量调节、应用启动及文本搜索等全功能操作。

首次使用时，discover 子命令可通过 SSDP 多播自动扫描局域网内的 Roku 设备并返回 IP 地址；后续所有操作均基于该 IP 通过标准 HTTP 请求（端口 8060）完成，无需 Roku 账户、API Key 或互联网连接。支持两种应用启动模式：通过数字 App ID 快速启动，或通过应用名称模糊匹配；文本输入功能可将完整搜索词一次性发送至 Roku，避免逐字符输入的低效体验。

显著优点

1. 零门槛部署：无认证、无云端依赖、无复杂配置，即开即用
2. 极低延迟：纯本地 HTTP 通信，响应速度远超红外遥控或云端方案
3. 功能完整：覆盖导航、播放、音量、电源、应用启动、文本搜索等全场景
4. 扩展性强：支持多设备映射（living_room/bedroom 等别名），易于与其他智能家居技能联动
5. 隐私安全：零数据上传，不收集任何用户信息

潜在缺点与局限性

1. 无法远程唤醒：ECP 协议限制，Roku 完全关机后无法通过网络开机（需 HDMI-CEC 或物理电源）
2. 音量/电源受限：非 Roku TV 或未启用 HDMI-CEC 时，音量与电源指令可能无效
3. 网络依赖：必须处于同一局域网，跨子网或 VPN 场景下不可用
4. 无状态反馈：部分命令无执行结果确认，无法获取当前播放进度等实时状态
5. SSDP 发现限制：部分路由器可能屏蔽 SSDP 多播，需手动指定 IP

适合人群

• 拥有 Roku TV、Streaming Stick、Ultra 等设备的本地网络用户
• 追求低延迟、高可靠遥控体验的智能家居爱好者
• 希望将 Roku 控制集成到自动化流程（如"观影模式"联动灯光调节）的高级用户
• 注重隐私、拒绝云端账户绑定的技术型用户

常规风险

• 网络暴露风险：若路由器配置不当导致 8060 端口暴露至公网，可能面临未授权访问（建议启用防火墙规则限制内网访问）
• IP 变动风险：DHCP 租期到期可能导致 Roku IP 变更，建议设置静态 IP 或 DHCP 保留
• 误操作风险：自然语言指令解析错误可能导致非预期操作（如错误启动应用）