✓ Verified 💻 Development ✓ Enhanced Data

Xiaomi Air Purifier

Monitor and control Xiaomi Air Purifier 4 Lite via Mi Cloud.

Rating: 4.9 (116 reviews)
Downloads: 12,766 downloads
Version: 1.0.0

Overview

Monitor and control Xiaomi Air Purifier 4 Lite via Mi Cloud.

Complete Documentation

View Source →

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:

bash

cd xiaomi-air-purifier && pnpm install

bash

pnpm exec xmihome login -u <email/phone> -p <password> -c <country>

Supported countries: sg, ru, us, cn

List devices to verify discovery:

bash

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.

bash

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

Installation

Terminal bash


openclaw install xiaomi-air-purifier

Copied!

💻Code Examples

example.sh

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]