三星电视智控

技能简介

该技能通过SmartThings平台连接并控制三星智能电视，支持开关机、音量调节、静音切换及流媒体应用启动等功能。

业务背景

该技能让业务人员无需寻找遥控器，通过自然语言即可操控三星智能电视。适用于会议室快速投屏、展厅设备统一管理、酒店客房服务升级等场景，降低多设备管理成本，提升终端用户体验与运营效率。

落地案例：某企业展厅部署多台三星电视用于产品演示。工作人员通过统一指令完成开机、调节音量、启动指定视频应用，无需逐台操作。IT管理员一次性配置OAuth凭证后，各楼层人员均可直接调用，避免反复授权流程，确保展会期间设备状态实时可控。

能做什么

• 远程开关电视电源
• 调节音量大小与静音状态
• 查询设备当前状态与可用功能
• 启动Netflix、Prime Video等流媒体应用
• 发现并保存设备专属的应用ID

使用说明

环境准备

执行以下命令安装依赖：

brew install python node

首次配置（一次性）

1. 访问 https://account.smartthings.com/tokens 创建个人访问令牌(PAT)
2. 将PAT设置为环境变量 SMARTTHINGS_TOKEN
3. 运行技能创建OAuth应用，获取手机登录链接
4. 在手机上打开链接完成登录，从跳转页面URL复制code参数
5. 重新运行技能并传入auth-code完成令牌交换
6. 若PAT创建应用失败(403)，先在普通机器用SmartThings CLI登录创建应用，再将client id/secret写入.env后执行code交换

设备绑定

使用SmartThings CLI列出设备JSON，找到电视设备ID，存入SMARTTHINGS_DEVICE_ID环境变量。

日常使用

直接发送指令即可控制电视，无需重复OAuth流程。重新运行setup可刷新凭证。

输入与输出

见下方输入与输出表格。

风险提示

• OAuth令牌存储于本地.env文件，需妥善保管
• 应用ID因设备型号而异，不可直接套用示例值
• 默认使用httpbin.org作为回调地址，敏感场景建议自定义redirect-uri
• PAT权限较大，建议仅授予必要范围

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/regenrek/samsung-smartthings/SKILL.md
来源类型：GitHub仓库