（4257期）Samsung Smartthings – 三星电视 SmartThings 智能遥控

三星电视 SmartThings 智能遥控 通过 SmartThings OAuth 控制三星智能电视，支持开关、音量、应用启动等功能，需自行配置 PAT 和设备 ID。 使用说明 功能概述 Samsung Smart TV Skill 是一套基于 SmartThings 平台的 OAuth 认证与设备控制方案，允许用户通过 Clawdbot 远程操控三星智能电视。该技能采用 OAuth-In 架构，需用户先在 Samsung 账户中创建个人访问令牌（PAT），随后完成 OAuth 应用授权流程，最终获取设备控制能力。 核心用法 初始化配置（一次性） 访问 https://account.smartthings.com/tokens 生成 PAT 运行技能创建 OAuth 应用（smartthings-clawdbot），获取 client ID/secret 在手机端打开授权 URL，登录 Samsung 账户后复制 redirect URL 中的 code 参数 重新运行技能完成 token 交换，凭证自动写入 ~/.clawdbot/.env 使用 SmartThings CLI 查询设备列表，将电视的 device ID 存入环境变量 日常控制 设备状态查询（电源、音量、当前输入源等） 基础控制指令：开关机、音量调节、静音切换 应用启动：需先手动打开目标应用，从设备状态中提取 appId 后保存复用 显著优点 官方生态集成：基于 Samsung 第一方 SmartThings API，非破解或逆向方案 细粒度权限控制：OAuth 范围限定为设备读取（r:devices:）与执行（x:devices:），最小权限原则 无浏览器依赖：默认 headless 模式，适合服务器/自动化场景 凭证持久化：token 自动存储，支持刷新续期 局限性与缺点 配置门槛高：需用户自行处理 PAT 创建、OAuth 流程、设备 ID 查询等多步骤，无图形化引导 应用 ID 不通用：第三方应用（如 YouTube）的 ID 因设备而异，必须逐台电视手动 discovery 依赖外部服务：默认使用 httpbin.org 作为 OAuth redirect endpoint，虽可自定义但增加复杂度 CLI 工具依赖：设备发现与管理依赖 SmartThings CLI，非纯 API 方案 适合人群 拥有三星 Tizen 系统智能电视的技术用户 已使用 SmartThings 生态并希望实现自动化脚本的家庭用户 愿意投入时间完成 OAuth 配置以获得稳定官方 API 支持的开发者 常规风险 凭证泄露风险：PAT 和 OAuth token 以明文形式存储于本地 .env 文件，需确保文件权限安全（建议 600） Token 过期：OAuth token 有效期有限，需定期重新授权或使用刷新机制 API 变更：SmartThings API 为 Samsung 私有平台，存在接口变更或弃用风险 设备兼容性：部分旧型号三星电视或特定地区型号可能不支持 SmartThings 集成 手动操作依赖：应用启动流程要求用户先手动操作电视以获取 appId，无法实现完全无人化配置 原始说明 Control Samsung TVs via SmartThings (OAuth app + device control).