← Back to Skills Marketplace
pegasus02

小米家居 (Xiaomi Home)

by Pegasus02 · GitHub ↗ · v1.2.1
cross-platform ⚠ suspicious
4980
Downloads
3
Stars
30
Active Installs
4
Versions
Install in OpenClaw
/install xiaomi-home
Description
[English] Control Xiaomi Home devices via local LAN using miiocli. Supports status checks, toggling power, and MIOT property manipulation for devices like smart plugs, humidifiers, and rice cookers. | [中文] 通过局域网利用 miiocli 控制米家智能设备。支持查看状态、开关控制以及对智能插座、加湿器、电饭煲等 MIOT 设备的属性调优。
Usage Guidance
Review before installing. Remove and rotate any exposed Xiaomi device tokens if they belong to you, do not publish or commit token inventories, avoid passing account passwords on the command line, keep debug logging off, and require explicit confirmation before commands that power or change appliances, cameras, routers, or other physical devices.
Capability Analysis
Type: OpenClaw Skill Name: xiaomi-home Version: 1.2.1 The skill is classified as suspicious due to its high-risk capabilities, despite lacking clear evidence of intentional malicious behavior. The `scripts/token_extractor.py` script requires the user's Xiaomi account credentials (username/password or QR code) to log into Xiaomi Cloud, then extracts sensitive device tokens and IPs. This script performs network requests to external Xiaomi cloud services (e.g., `account.xiaomi.com`, `api.io.mi.com`) and starts a local HTTP server on port 31415 for displaying CAPTCHA or QR codes. Additionally, the `SKILL.md` includes an installation command that executes shell commands (`pipx install python-miio && /Users/$(whoami)/.local/pipx/venvs/python-miio/bin/python -m pip install 'click<8.1.0'`). While these actions are aligned with the stated purpose of controlling Xiaomi devices, the handling of sensitive credentials and tokens, combined with network and shell access, represents a significant security risk if the script were compromised or misused.
Capability Assessment
Purpose & Capability
Local Xiaomi device control via miiocli is coherent with the stated purpose, and token discovery can support setup, but the artifact also bundles a private-looking inventory with real-looking tokens for plugs, cameras, routers, and other devices.
Instruction Scope
The skill maps natural-language requests to commands that can change physical device state, including plugs, humidifiers, and cookers, without clear confirmation or safety boundaries.
Install Mechanism
The install metadata runs a disclosed pipx install for python-miio and a click dependency adjustment; this is purpose-aligned but executes shell commands and depends on external Python packages.
Credentials
The token extractor logs into Xiaomi Cloud by password or QR flow, contacts Xiaomi account/API endpoints, retrieves device tokens and BLE keys, and can expose QR/captcha images through a local HTTP server bound on all interfaces.
Persistence & Privilege
The documentation tells users to store IPs and tokens in markdown for agent recall, and the package includes references/my_private_devices.md marked sensitive with real-looking plaintext tokens.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install xiaomi-home
  3. After installation, invoke the skill by name or use /xiaomi-home
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
v1.2.1 升级:ClawdHub 详情页及 SKILL 说明全面支持中英双语,方便全球开发者使用。
v1.2.0
v1.2.0 升级:引入了意图映射表,标准化了控制逻辑,增强了对 MIOT 协议设备(如热水器插座)的精准控制指令。
v1.1.0
新增:内置了 Token 提取脚本(scripts/token_extractor.py),现在用户可以直接运行本地脚本来获取设备钥匙了。
v1.0.0
初始版本:支持通过代码硬控米家 WiFi 设备,包含依赖冲突修复逻辑。
Metadata
Slug xiaomi-home
Version 1.2.1
License
All-time Installs 187
Active Installs 30
Total Versions 4
Frequently Asked Questions

What is 小米家居 (Xiaomi Home)?

[English] Control Xiaomi Home devices via local LAN using miiocli. Supports status checks, toggling power, and MIOT property manipulation for devices like smart plugs, humidifiers, and rice cookers. | [中文] 通过局域网利用 miiocli 控制米家智能设备。支持查看状态、开关控制以及对智能插座、加湿器、电饭煲等 MIOT 设备的属性调优。 It is an AI Agent Skill for Claude Code / OpenClaw, with 4980 downloads so far.

How do I install 小米家居 (Xiaomi Home)?

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

Is 小米家居 (Xiaomi Home) free?

Yes, 小米家居 (Xiaomi Home) is completely free (open-source). You can download, install and use it at no cost.

Which platforms does 小米家居 (Xiaomi Home) support?

小米家居 (Xiaomi Home) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 小米家居 (Xiaomi Home)?

It is built and maintained by Pegasus02 (@pegasus02); the current version is v1.2.1.

💬 Comments