xiaomi

What This Skill Does

The Xiaomi Home Control skill acts as a bridge between the OpenClaw agent and your local Mi Home ecosystem. By leveraging the miiocli library, this skill allows for low-latency, direct communication with smart home devices over your local area network (LAN). Instead of routing commands through the cloud, which can be slow and unreliable, this skill executes requests directly to the device IP. It supports a wide array of functionality, including power toggling, property modification (such as adjusting humidifier settings), and status retrieval for smart plugs, rice cookers, and various other MIOT-compatible hardware. The skill includes a robust token extraction utility, simplifying the technical overhead typically associated with authenticating local device access.

Installation

To integrate this skill into your environment, use the OpenClaw package manager. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/yiqiezhenxi/home-xiaomi

Once installed, navigate to the scripts/ directory to run python3 scripts/token_extractor.py. You will need your Xiaomi account credentials to retrieve the necessary IP addresses and 32-character tokens for your hardware. After extraction, populate the references/devices.md file with your device data to enable the agent to map natural language intents to specific hardware addresses.

Use Cases

This skill is ideal for users looking to build a local-first home automation hub. Use it to automate energy management by toggling smart plugs based on time or occupancy, monitor appliance status for efficiency, or create multi-step routines (like 'prepare breakfast' which interacts with a rice cooker and coffee machine simultaneously). Because it operates over the LAN, it functions perfectly even during temporary internet outages, provided your local router remains active.

Example Prompts

1. "Turn on the water heater in the bathroom immediately."
2. "Set the bedroom humidifier to maximum intensity."
3. "Check if the rice cooker has finished the cooking cycle."

Tips & Limitations

• Static IPs: We strongly recommend assigning static IP addresses to your Xiaomi devices via your router settings. If a device IP changes (DHCP lease renewal), the agent will be unable to communicate with it until the devices.md file is updated.
• Compatibility: While it covers most MIOT devices, obscure or very new sensors might require custom SIID/PIID mapping. Check the miiocli documentation if your specific model isn't responding.
• Security: Because this skill performs local network requests and handles security tokens, ensure that your local network is secured and you only provide device data to trusted environments.