xiaomi-air-purifier
✓Verified·Scanned 2/18/2026
This skill controls Xiaomi Air Purifier devices via Mi Cloud using a CLI script and the xmihome library. It reads path.join(process.env.HOME, '.config/xmihome/credentials.json'), writes path.join(__dirname, '..', 'config.json'), calls '/v2/home/device_list', '/miotspec/prop/get', '/miotspec/prop/set', and instructs running pnpm install / node scripts/purifier.js.
from clawhub.ai·v0ae4deb·49.2 KB·0 installs
Scanned from 1.0.2 at 0ae4deb · Transparency log ↗
$ vett add clawhub.ai/radyakaze/xiaomi-air-purifier
Xiaomi Air Purifier Control
Control and monitor Xiaomi Air Purifier 4 Lite (zhimi.airp.rmb1) via Xiaomi Cloud API. Supports multiple devices and room-based targeting.
Setup
- Install dependencies:
cd xiaomi-air-purifier && pnpm install
- Login to Mi Cloud (OTP will be sent via SMS/Email):
pnpm exec xmihome login -u <email/phone> -p <password> -c <country>
Supported countries: sg, ru, us, cn
- List devices to verify discovery:
node scripts/purifier.js devices
Usage
Commands can be targeted by Room Name, Device Name, or DID. If no target is provided, it uses the selected default or the only available device.
node scripts/purifier.js status [room] # Check status (e.g., status Bedroom)
node scripts/purifier.js status-full [room] # Show full status (incl. filter)
node scripts/purifier.js on [room] # Power on
node scripts/purifier.js off [room] # Power off
node scripts/purifier.js mode <0-2> [room] # 0=Auto, 1=Sleep, 2=Favorite
node scripts/purifier.js level <0-14> [room]# Fan speed (Favorite mode)
node scripts/purifier.js brightness <0-2> [room]
node scripts/purifier.js buzzer <on|off> [room]
node scripts/purifier.js lock <on|off> [room]
Quick Reference
| Property | siid | piid | Type | Description |
|---|---|---|---|---|
| Power | 2 | 1 | bool | On/Off |
| Mode | 2 | 4 | int | 0=Auto, 1=Sleep, 2=Favorite |
| Humidity | 3 | 1 | int | Relative humidity (%) |
| PM2.5 | 3 | 4 | int | Air quality (μg/m³) |
| Temperature | 3 | 7 | float | Temperature (°C) |
| Filter Life | 4 | 1 | int | Filter remaining (%) |
| Buzzer | 6 | 1 | bool | Notification sound on/off |
| Child Lock | 8 | 1 | bool | Physical button lock |
| Fan Level | 9 | 11 | int | 0-14 (Favorite mode) |
| Brightness | 13 | 2 | int | 0=Off, 1=Dim, 2=On |