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 设备的属性调优。
Why use this skill?
Control your Xiaomi Mi Home devices locally with OpenClaw. Features automated token extraction, smart plug support, and low-latency LAN commands for your smart home.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/pegasus02/xiaomi-homeWhat This Skill Does
The xiaomi-home skill for OpenClaw provides a powerful, localized interface to control your Mi Home (Xiaomi) ecosystem without relying on unstable cloud triggers. By leveraging the 'miiocli' library, this skill communicates directly with devices over your local area network (LAN), ensuring that commands for smart plugs, humidifiers, and rice cookers are processed with minimal latency. It effectively bridges the gap between raw hardware protocols and natural language, enabling your AI agent to act as a sophisticated smart home controller. The skill includes automated routines for fetching authentication tokens from Xiaomi servers, simplifying what is often a tedious manual configuration process.
Installation
To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/pegasus02/xiaomi-home. Upon installation, navigate to the scripts directory and run python3 scripts/token_extractor.py to authenticate your account and retrieve the necessary IPs and Tokens for your smart devices. Once retrieved, map these details into references/devices.md. The skill will automatically handle common dependency issues, such as version conflicts with click, ensuring your environment remains stable and ready for execution.
Use Cases
- Home Automation: Control non-smart legacy appliances by plugging them into a Xiaomi Smart Plug, allowing you to toggle power via voice command.
- Climate Control: Adjust humidifier intensity or settings dynamically based on sensor input or time of day.
- Kitchen Management: Check the status of your smart rice cooker to see if your meal is finished, or trigger warm-up modes remotely.
- Network Efficiency: Use this for IoT management when cloud connectivity is poor, as it relies entirely on local network communication.
Example Prompts
- "Turn on the water heater in the bathroom, please."
- "Set the humidifier to the maximum intensity setting."
- "Is the rice ready in the kitchen? Check the status for me."
Tips & Limitations
Ensure all devices are on the same local network as your agent. While the local control is faster than the cloud, device firmware updates might occasionally change property IDs (siid/piid). Always consult the references/devices.md file if a device fails to respond. For advanced users, you can use the raw_command feature to experiment with undocumented MIOT properties for your specific hardware models.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-pegasus02-xiaomi-home": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, file-write, code-execution