Mi Home (米家) Control

Control Xiaomi smart home devices and create automations via cloud API.

Setup

Prerequisites: INLINECODE0

Credentials: ~/.mijia_creds.json (chmod 600)
CODEBLOCK0

If login requires 2FA (device trust verification), obtain credentials via browser:

1. 1. Open https://account.xiaomi.com/pass/serviceLogin?sid=xiaomiio&_json=true in browser with existing cookies
2. POST to serviceLoginAuth2 with hash password to get ssecurity + INLINECODE5
3. Follow location URL to get serviceToken from cookies

Device Control

List devices

Read property

Set property

Note: Mesh devices (BLE switches) return code:1 on set — this is normal (async confirmation). The command still executes. Verify by reading the property after a 1-2 second delay.

Batch control

[
  {"did": "946635824", "siid": 2, "piid": 1, "value": true},
  {"did": "946633803", "siid": 2, "piid": 1, "value": false}
]

MIoT Spec Reference

Each device has services (siid) → properties (piid). Look up specs at:
INLINECODE8

Common patterns:

• - Switch/Light: siid:2 piid:1 = on/off (bool)
• 3-way switch: siid:2/3/4 piid:1 = channel 1/2/3 (bool)
• AC: siid:2 piid:1 = on/off, piid:2 = mode, piid:3 = target temp
• Bath heater: siid:2 = light, siid:3 = PTC heater, siid:10 = environment (temp sensor)
• Water heater: siid:2 piid:1 = on/off, piid:2 = target temp, piid:3 = current temp

Create Automation Scenes

CODEBLOCK6

Scene JSON format (see references/scene_template.json):
CODEBLOCK7

Key fields:

• - trigger.key: format event.<did>.<siid>.<eiid> for device events
• INLINECODE12: optional conditions (e.g., only if light is off)
• INLINECODE13: JSON string with props array
• INLINECODE15: 8 = user automation
• INLINECODE16 and uid are auto-filled if omitted

Predefined Scenes

🚿 Bath Mode (洗澡模式)

1. 1. Read bathroom temp: INLINECODE18
2. If temp < 28°C → turn on bath heater: set 927361805 3 1 1 (暖风), target 30°C
3. If temp ≥ 28°C → skip heater
4. Turn on water heater: set 965879649 2 1 1, set 43°C: INLINECODE21
5. Turn on bathroom light: INLINECODE22

🐟 Auto Fish Feeding (出门自动喂鱼)

Architecture:

1. 1. OpenClaw cron (every 5min): polls door lock event log via INLINECODE23
2. If today has an auto-lock event (action=1) AND not fed yet → feed fish → record state
3. After feeding, all subsequent checks skip immediately (daily dedup)
4. State file ~/.fish_feed_state.json: tracks last feed date

Components:

• - Door lock events: 智能门锁2 Pro (did: 1175215651), event key 2.1020, action=1 = auto-lock (leaving home)
• Fish feeder: 智能鱼缸 (did: 2026943875), action siid:2 aiid:1, in:[1] (1 portion)

• - Script: INLINECODE28

Manual commands:
CODEBLOCK8

Trigger logic:

• - Polls lock event log for auto-lock (action=1) today → feed fish
• Once fed, skips all further checks until next day
• No米家自动化 needed, pure OpenClaw polling

小爱音箱 TTS

Make the XiaoAI speaker say something aloud.

CODEBLOCK9

Flow: unmute → play-text → wait → pause playback → re-mute.
This prevents the speaker from auto-playing music after TTS.

Important:

• - Speaker may be muted (default state at night) — script handles unmute/re-mute automatically
• After TTS, always pause playback to prevent auto-music
• Cloud API cannot control screen UI — returning to clock display requires physical tap or voice command

Token Refresh

Tokens expire periodically. If API returns decode errors or auth failures:

1. 1. Re-login via browser (same flow as initial setup)
2. Update ~/.mijia_creds.json with new serviceToken and INLINECODE31

The ssecurity changes each login. The serviceToken is session-bound.