← Back to Skills Marketplace
pegasus02

小米家居 (Xiaomi Home)

by Pegasus02 · GitHub ↗ · v1.2.1
cross-platform ⚠ suspicious
5157
Downloads
3
Stars
0
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 carefully before installing. Do not publish or commit Xiaomi tokens, remove any real private inventory from the package, rotate exposed device tokens where possible, keep debug logging off, avoid passing passwords on the command line, and require explicit confirmation before controlling heaters, cookers, 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 control via miiocli fits the purpose, and token discovery can support setup, but the bundled workflow logs into Xiaomi Cloud, enumerates homes/devices across regions, extracts LAN tokens and BLE keys, and includes real-looking device credentials for cameras, routers, and appliances.
Instruction Scope
The skill maps natural-language commands directly to state-changing smart-home actions such as powering plugs and changing appliance modes, with no clear confirmation, allowlist, or safety boundary guidance.
Install Mechanism
The install metadata discloses a shell command that installs python-miio with pipx and adjusts a Python dependency; this is purpose-aligned but depends on external package execution.
Credentials
The token extractor takes Xiaomi credentials or QR login, contacts Xiaomi account/API endpoints, logs sensitive authentication/session values when debug logging is enabled, and serves QR/captcha images from an unauthenticated HTTP server bound to all interfaces on port 31415.
Persistence & Privilege
The documentation tells users to store device IPs and tokens in markdown for agent recall, and the package includes references/my_private_devices.md containing private IPs and live-looking 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 0
Active Installs 0
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 5157 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