xiaomi-air-purifier

What This Skill Does

The xiaomi-air-purifier skill provides a robust interface for monitoring and controlling your Xiaomi Air Purifier 4 Lite (model zhimi.airp.rmb1) directly from your OpenClaw environment. By leveraging the Xiaomi Cloud API, this skill abstracts the complexities of network protocols into simple, human-readable commands. It allows you to toggle power states, adjust fan modes (Auto, Sleep, Favorite), modify fan levels, control device brightness, toggle the buzzer, and manage the child lock feature. Furthermore, it provides real-time telemetry including indoor air quality (PM2.5 levels), humidity, temperature, and current filter life, ensuring you can maintain a healthy living environment through intelligent automation.

Installation

To integrate this skill, ensure you are using the OpenClaw framework. First, install the skill via the CLI: clawhub install openclaw/skills/skills/radyakaze/xiaomi-air-purifier. Once installed, navigate to the skill directory and install the necessary Node.js dependencies using pnpm install. Authentication is required for secure access to your devices via Mi Cloud. Execute the login command: pnpm exec xmihome login -u <email/phone> -p <password> -c <country>. Be prepared to handle an OTP verification sent to your registered email or phone number. Finally, confirm your device discovery by running node scripts/purifier.js devices to list your active air purifiers.

Use Cases

This skill is ideal for home automation enthusiasts and smart office managers. Use it to automatically turn on your purifier when indoor air quality drops (detected via PM2.5 readings), silence the device at night using the buzzer and brightness controls, or optimize energy consumption by scheduling the fan level based on the time of day. It is perfect for multi-room setups where you need to manage multiple purifiers independently or simultaneously.

Example Prompts

1. "OpenClaw, what is the current PM2.5 level and humidity in the Bedroom?"
2. "Turn on the Living Room air purifier and set the mode to Sleep."
3. "Is the filter life in my study purifier still good?"

Tips & Limitations

Ensure your device is connected to the same Mi Cloud account used for authentication. If you have multiple devices, always specify the room name to avoid ambiguity. The 'Level' setting only applies when the device is in 'Favorite' mode (Mode 2). Monitor the 'Filter Life' property regularly to ensure timely maintenance. Note that this skill requires an active internet connection to communicate with the Xiaomi Cloud servers.