← Back to Skills Marketplace
651
Downloads
63
Stars
3
Active Installs
6
Versions
Install in OpenClaw
/install tuya-smart-control
Description
Control Tuya smart home devices via natural language. Use when the user asks to control smart devices (turn on/off lights, AC, plugs, adjust brightness/tempe...
Usage Guidance
This skill appears internally consistent with its stated purpose, but take these precautions before installing:
- Only provide a TUYA_API_KEY you control and understand; this key can control devices, send notifications, and fetch/decrypt camera media — protect it like a password.
- Run the WebSocket client and CLI on a trusted backend (the skill explicitly warns against browser/mobile usage) and do not expose TUYA_API_KEY to frontends.
- Review the included Python code (tuya_api.py, tuya_device_mq_client.py) yourself and verify the claimed GitHub source if you need provenance; the registry lists the source as unknown but SKILL.md points to a GitHub repo — confirm the repo/owner before trusting.
- Be mindful of privacy: IPC capture can return playable/decrypted URLs when consent is accepted. Only use capture features with explicit user consent and audit any stored media or forwarded URLs.
- If you allow autonomous agent invocation, remember the agent could call device-control or notification endpoints automatically; consider policy controls or requiring explicit user confirmation for destructive or privacy-sensitive actions.
- If you suspect a key was exposed, rotate/revoke the TUYA_API_KEY immediately.
Capability Analysis
Type: OpenClaw Skill
Name: tuya-smart-control
Version: 1.0.5
The tuya-smart-control skill is a well-documented and legitimate integration for managing Tuya smart home devices via the Tuya Open Platform. The Python SDK (tuya_api.py) and WebSocket client (tuya_device_mq_client.py) implement standard authentication and communication with official Tuya endpoints (e.g., openapi.tuyaus.com, wsmsgs.iot-wus.com). The SKILL.md instructions provide clear workflows for device control, notifications, and camera captures while explicitly prohibiting high-risk operations like smart lock control or firmware updates. No evidence of malicious intent, data exfiltration to third parties, or prompt-injection attacks was found.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match the included code and references. The only required environment variable is TUYA_API_KEY and the code (tuya_api.py, tuya_device_mq_client.py) implements REST calls and WebSocket subscriptions to Tuya endpoints — exactly what a Tuya control skill needs.
Instruction Scope
SKILL.md instructs the agent to read TUYA_API_KEY (and optional TUYA_BASE_URL), run the provided CLI or import the included Python SDK, and run the WebSocket client server-side. The instructions do not request unrelated system files or unrelated credentials. The skill does include capabilities with privacy implications (camera capture, decrypted media URLs, and sending SMS/voice/mail/push to the account's bound contacts) and the docs explicitly mention consent and server-side operation.
Install Mechanism
No download/install from arbitrary URLs. This is instruction-only with bundled Python scripts and a requirements.txt listing requests and websockets — proportional to the functionality. No extract-from-unknown-host or URL-shortener installs are present.
Credentials
The skill requests a single credential TUYA_API_KEY (declared as primaryEnv), which is appropriate. However, that single API key grants broad control over the user's Tuya account (device control, notifications, IPC capture). Treat the key as highly sensitive and ensure it has appropriate account-level restrictions and is only used on trusted servers.
Persistence & Privilege
The skill is not always-enabled and uses normal model invocation. It does not attempt to modify other skills or system-wide settings. The provided WebSocket client is intended to run server-side and will persist a connection only while running.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tuya-smart-control - After installation, invoke the skill by name or use
/tuya-smart-control - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
No user-visible changes in this release.
- Version bump to 1.0.5 with no detected file changes.
- All features and documentation remain unchanged.
v1.0.4
**1.0.4 Summary: Adds real-time device event monitoring and messaging via WebSocket.**
- Introduced real-time device message subscription over WebSocket through a new client (`tuya_device_mq_client.py`), allowing live monitoring of device property/status changes.
- Expanded documentation (`SKILL.md` and new `references/device-message.md`) to cover usage, configuration, and data center mapping for event subscription.
- Updated dependencies: now requires `websockets>=12.0` in addition to previous packages.
- The `description` now mentions real-time event monitoring and WebSocket support.
- No changes to existing REST API or device control flows; all features remain compatible.
v1.0.3
Version 1.0.3
- Added detailed API documentation: api conventions, error handling, and IPC cloud capture guides in the `references/` directory.
- Introduced CLI validation, new device, IPC camera capture, and notification commands to the CLI.
- Updated documentation for CLI usage, arguments, and validation rules; CLI is now recommended as the primary usage method.
- Expanded feature overview to cover error handling, IPC cloud capture, API conventions, and clarified all modules.
- Clarified and detailed device control workflows, error conditions, user intent mapping, and property access modes.
- Added Python dependencies file (`scripts/requirements.txt`).
v1.0.2
- Added links to Official Website and Source Code in the Basic Information section.
- No functional or behavioral changes; documentation update only.
- Clarified skill source and project homepage for easier access to resources.
v1.0.1
- Updated and streamlined the skill description to highlight official status, global coverage, and simple onboarding via tuya.ai.
- Clarified that developers can use natural language for smart device control, notifications, weather, and data statistics across 3,000+ device categories in 200+ countries.
- Updated instructions for API key acquisition (China: tuyasmart.com, international: tuya.ai).
- No code or functional changes; documentation only.
v1.0.0
Tuya Smart Control Skill 1.0.0 – Initial release
- Introduces smart home control via Tuya Open Platform APIs: manage homes, rooms, and devices.
- Supports device control (e.g., turn on/off, adjust brightness/temperature), status queries, and renaming.
- Offers notification features: send SMS, voice calls, emails, or app push notifications.
- Provides weather information and device statistics querying.
- Python SDK and CLI provided; API key required for configuration.
- Automatic region detection from API key prefix for seamless setup.
Metadata
Frequently Asked Questions
What is Tuya Smart Control?
Control Tuya smart home devices via natural language. Use when the user asks to control smart devices (turn on/off lights, AC, plugs, adjust brightness/tempe... It is an AI Agent Skill for Claude Code / OpenClaw, with 651 downloads so far.
How do I install Tuya Smart Control?
Run "/install tuya-smart-control" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tuya Smart Control free?
Yes, Tuya Smart Control is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tuya Smart Control support?
Tuya Smart Control is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tuya Smart Control?
It is built and maintained by Tuya-Open (@gaosq856); the current version is v1.0.5.
More Skills