智控无界
万物互联
通过 REST API、AI Agent Skill 或 CLI 工具， 一个 API Key 即可接入涂鸦智能全生态， 掌控 3,000+ 智能硬件品类。
npm install -g tuya-smart-control-cli灵活对接，极简智控
无论是构建 AI 应用、集成自动化脚本，还是在终端管理设备，都有适合你的方式
开放 REST API
标准 HTTP 接口，任何语言均可调用。Bearer Token 认证，区域自动检测，支持家庭管理、设备控制、天气查询、消息通知全能力。
- Bearer Token 认证
- 区域自动检测
- 统一响应格式
- Python SDK 封装
AI Agent Skill
专为 AI 智能体设计的技能插件，可一键安装到 Claude、GPT 等 AI Agent 中，通过自然语言直接控制智能家居设备。
- OpenClaw / ClawHub 支持
- 11 大内置工作流
- 自然语言控制
- MIT-0 开源协议
命令行工具
官方 Node.js 命令行工具，npm 一键安装，在终端管理智能家居设备。支持 --json 输出，方便脚本集成和自动化流水线。
- tuya init 快速配置
- 设备查询与控制
- 实时事件订阅
- --json 管道输出
几行代码，掌控全屋
提供 Python SDK 和 CLI 两种使用方式，按需选择
from tuya_api import TuyaAPI
api = TuyaAPI() # auto-reads TUYA_API_KEY
# List all devices
devices = api.get_all_devices()
# Query device Thing Model
model = api.get_device_model("device_id")
# Turn on light, set brightness 500
api.issue_properties("device_id", {
"switch_led": True,
"bright_value": 500,
"work_mode": "white"
})
# Get weather (Beijing)
weather = api.get_weather(
lat="39.9042", lon="116.4074"
)全场景能力覆盖，开箱即用
从设备查询到实时订阅，从消息通知到设备控制，覆盖智能设备管理的完整场景
家庭与空间管理
查询所有家庭、房间列表，获取地理位置信息用于天气查询，支持多家庭多房间层级结构。
设备查询与控制
获取设备列表及实时状态，查询物模型（含属性类型与取值范围），下发控制指令，支持 bool/value/enum/string 类型属性。
天气服务
基于经纬度获取实时及未来最多 7 小时天气预报，支持温度、湿度、气压、风速、紫外线等多维数据。
消息通知
向当前用户发送短信、语音电话、邮件和 App 推送，适用于设备告警、异常提醒等场景，支持自发送模式。
数据统计
查询设备用电量等统计指标，支持按小时粒度的 SUM/MAX/MIN 聚合，时间窗口最大 24 小时，助力能耗分析。
IPC 云端抓拍
对摄像头设备触发云端截图和短视频录制，配合 AI 视觉识别实现看门狗、安防等场景。
设备消息实时订阅 (WebSocket)
通过 WebSocket 实时接收设备属性变化和上下线事件，适用于事件驱动自动化、实时状态看板、异常告警。7 大数据中心 WebSocket 端点，API Key 前缀自动检测，断线自动重连。
一个 API Key，
连接万物智联
立即获取 API Key，通过 REST API、AI Agent Skill 或 CLI 开始构建你的智能家居应用
相关资源
文档、开源仓库与开发者平台入口
