360 Secure SkillHub
360 安全技能中心

Tuya Smart Home

这是一款可通过云API或本地网络控制Tuya/Smart Life智能家居设备（如宠物喂食器、灯、插座、窗帘等）的工具，核心功能包括扫描本地设备、查询设备信息与状态、发送控制指令。典型场景有远程喂宠、智能家居管控、查看设备电量/温度等，支持云模式（需IoT凭证）和推荐的本地模式（需设备本地信息），通过命令行脚本执行操作。

rachelchoo1212
rachelchoo1212
热度 74.88
最近更新 2026-05-11 17:27:54
分类：开发依赖：代码执行 / 第三方 API应用场景：API 集成 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add tuya-smart-home
Metadata
name
tuya-smart-home
description
Control Tuya/Smart Life smart home devices including pet feeders, lights, plugs, curtains via cloud API or local network. Use when: (1) controlling smart home devices, (2) feeding pets remotely, (3) managing Tuya/Smart Life devices, (4) scanning local Tuya devices, (5) querying device status like battery or temperature.

Tuya Smart Home

Control any Tuya/Smart Life device via cloud API or local network.

Dependencies

pip3 install tinytuya tuya-connector-python

Configuration

Two control modes available:

Cloud Mode

Requires Tuya IoT Platform credentials from https://iot.tuya.com:

  • ACCESS_ID — from Cloud Project
  • ACCESS_SECRET — from Cloud Project
  • REGION — cn (China), us (Americas/SEA), eu (Europe), in (India)

Local Mode (Recommended)

Requires device info (obtain via cloud API first):

  • DEVICE_ID — device identifier
  • LOCAL_KEY — device encryption key
  • IP — device local IP address
  • VERSION — protocol version (usually 3.4)

Quick Start

Scan for devices on local network

python3 scripts/tuya_scan.py

Get device info (cloud)

python3 scripts/tuya_control.py --mode cloud --action info \
  --device-id DEVICE_ID \
  --access-id ACCESS_ID --access-secret ACCESS_SECRET --region cn

Query device status

# Cloud
python3 scripts/tuya_control.py --mode cloud --action status \
  --device-id DEVICE_ID \
  --access-id ACCESS_ID --access-secret ACCESS_SECRET --region cn

# Local
python3 scripts/tuya_control.py --mode local --action status \
  --device-id DEVICE_ID --ip IP --local-key KEY

Send command

# Cloud — feed pet 1 portion
python3 scripts/tuya_control.py --mode cloud --action send \
  --device-id DEVICE_ID --code manual_feed --value 1 \
  --access-id ACCESS_ID --access-secret ACCESS_SECRET --region cn

# Local — feed pet 1 portion
python3 scripts/tuya_control.py --mode local --action send \
  --device-id DEVICE_ID --ip IP --local-key KEY \
  --dp-id 3 --value 1

# Turn on light
python3 scripts/tuya_control.py --mode cloud --action send \
  --device-id DEVICE_ID --code switch_led --value true \
  --access-id ACCESS_ID --access-secret ACCESS_SECRET --region cn

# Open curtain
python3 scripts/tuya_control.py --mode cloud --action send \
  --device-id DEVICE_ID --code control --value open \
  --access-id ACCESS_ID --access-secret ACCESS_SECRET --region cn

Common Device Commands

Device Code Values Description
Pet Feeder manual_feed 1-12 Feed N portions
Pet Feeder quick_feed true Quick feed
Pet Feeder light true/false Night light
Light switch_led true/false On/off
Light bright_value 10-1000 Brightness
Light temp_value 0-1000 Color temperature
Plug switch_1 true/false On/off
Curtain control open/stop/close Movement
Curtain percent_control 0-100 Position %

China Region Note

China data center (openapi.tuyacn.com) blocks non-China IPs by default. Solutions:

  1. Add your IP to whitelist in Tuya IoT Platform → Project → IP Whitelist
  2. Use local mode (bypasses cloud entirely, recommended)

API Reference

For detailed API documentation, DP code tables, and setup guide, see references/tuya_api.md.