← 返回 Skills 市场
651
总下载
63
收藏
3
当前安装
6
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
功能分析
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.
能力标签
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install tuya-smart-control - 安装完成后，直接呼叫该 Skill 的名称或使用
/tuya-smart-control触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 651 次。
如何安装 Tuya Smart Control？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install tuya-smart-control」即可一键安装，无需额外配置。
Tuya Smart Control 是免费的吗？
是的，Tuya Smart Control 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Tuya Smart Control 支持哪些平台？
Tuya Smart Control 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Tuya Smart Control？
由 Tuya-Open（@gaosq856）开发并维护，当前版本 v1.0.5。
推荐 Skills