← Back to Skills Marketplace
yzlkj

yzl-iot-api

by yzlkj · GitHub ↗ · v1.4.0 · MIT-0
cross-platform ✓ Security Clean
250
Downloads
1
Stars
0
Active Installs
11
Versions
Install in OpenClaw
/install yzl-iot-api
Description
云智联 IoT 设备管理API v1.4.0。一句话说就能获取传感器数据和发送控制指令。激活语:云智联设备,钥匙是xxxxxx,帮我打开开关/获取数据
Usage Guidance
This skill appears coherent and only needs the IoT API key to contact the cloud endpoint. Before installing: (1) confirm the API key is from your legitimate 云智联 account and grant the least privilege key possible; (2) review the repository (homepage) yourself if you can—there are minor version/metadata mismatches in the package files; (3) consider running the tool in a network-isolated environment or with a scoped API key until you’re comfortable; (4) rotate the API key if you decide to remove the skill or if it’s ever exposed. If you need higher assurance, ask the maintainer for a signed release or an explanation of the mixed API path prefixes and version discrepancies.
Capability Analysis
Type: OpenClaw Skill Name: yzl-iot-api Version: 1.4.0 The skill is a legitimate IoT management tool for the YZL (云智联) platform, allowing users to monitor sensors and control valves via the official API (open.yzlkj.com). The code in tool.py is well-structured, using only standard Python libraries and implementing proper security practices such as authentication via environment variables (YZLIOT_API_KEY) and client-side rate limiting. No evidence of malicious behavior, data exfiltration, or harmful prompt injection was found.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description (云智联 IoT device management) align with the code and SKILL.md: the tool implements device listing, history, and command sending and only requires an IoT API key. Minor inconsistencies: API path naming in tool.py mixes /openv1/ and /open/ prefixes (could be API drift), and package metadata files show differing version numbers (SKILL.md/version metadata vs _meta.json). These look like bookkeeping issues, not evidence of malicious intent.
Instruction Scope
SKILL.md instructs the agent and user to set YZLIOT_API_KEY and to run python3 tool.py for manual commands. The runtime instructions do not ask for unrelated files, system credentials, or exfiltration endpoints, and the code only reads YZLIOT_API_KEY from the environment and contacts the declared BASE_URL (open.yzlkj.com).
Install Mechanism
No install spec is provided (instruction-only install), and the tool is a Python script that expects python3 on PATH. There is no network download/install step or archived payload; the source code is included in the package.
Credentials
Only one required environment variable (YZLIOT_API_KEY) is declared and used; that is proportionate for calling a cloud IoT API. The code does not access other environment variables or local config paths.
Persistence & Privilege
The skill does not request always:true and does not try to modify other skills or global agent config. Default autonomous invocation remains (normal for skills).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install yzl-iot-api
  3. After installation, invoke the skill by name or use /yzl-iot-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.4.0
- 修正版本号显示,版本历史增加 v1.3.9 记录 - 其余文档内容保持不变
v1.3.9
- 修正版本号显示,确保文档描述与实际版本一致 - 无其他功能变更
v1.3.8
- 更新 API 版本号描述至 v1.3.7 - 无其他功能或界面变更,仅文档 SKILL.md 中版本号信息修正
v1.3.7
- 移除硬编码的默认 API 密钥,提升安全性 - 现在 YZLIOT_API_KEY 环境变量为必填项 - 运行文档和描述修正,确保与实际行为一致
v1.3.6
v1.3.6 introduces improved documentation and detailed device model support. - Added comprehensive device model explanations for soil sensors, valves, and liquid level sensors. - Updated API Key requirement: now optional; uses a built-in key by default. - Expanded natural language support for device control and data retrieval commands. - Enhanced quick-start and usage instructions for end users. - Included request rate limits and automatic handling of rate limit errors.
v1.2.3
- Added homepage and metadata fields to SKILL.md for improved documentation and integration support. - No changes to functionality or commands.
v1.2.2
- Updated description to version v1.2.2. - Added a new "运行时要求" section specifying Python 3.6+ and required environment variable. - Clarified that setting the `YZLIOT_API_KEY` environment variable is mandatory for use. - No changes to commands, usage, or API functionality.
v1.2.1
- Added activation phrase guidance (“激活语”) in the description for easier skill invocation.
v1.2.0
Version 1.2.0 - 增加通过“一句话”命令获取全部设备和数据,简化操作体验 - 新增 device-history 命令,可一键获取设备所有设施历史数据 - 优化命令参数说明与命令示例,更易理解 - SKILL.md 文档全面升级,结构更简洁,易用性提升 - 更新常用设施ID和设备说明
v1.1.0
新增历史数据功能,修复GET+Body调用方式
v1.0.0
完整版 - 支持设备查询和控制
Metadata
Slug yzl-iot-api
Version 1.4.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 11
Frequently Asked Questions

What is yzl-iot-api?

云智联 IoT 设备管理API v1.4.0。一句话说就能获取传感器数据和发送控制指令。激活语:云智联设备,钥匙是xxxxxx,帮我打开开关/获取数据. It is an AI Agent Skill for Claude Code / OpenClaw, with 250 downloads so far.

How do I install yzl-iot-api?

Run "/install yzl-iot-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is yzl-iot-api free?

Yes, yzl-iot-api is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does yzl-iot-api support?

yzl-iot-api is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created yzl-iot-api?

It is built and maintained by yzlkj (@yzlkj); the current version is v1.4.0.

💬 Comments