Connecting the Xiaomi gateway to Alice: full instructions with nuances

Voice control of the smart home via Alice from Yandex has become the standard for owners of Xiaomi equipment. But many users face problems when trying to connect the Xiaomi gateway (be it Mi Gateway, Aqara Hub or other models) with the Yandex ecosystem. In this article, we will analyze all the working ways of integration for 2026, from basic settings through Mi Home to bypassing typical synchronization errors.

It is important to understand that official support for Xiaomi in Yandex.Smart Home is limited, but there are workarounds. We tested them on the Mi Gateway 3, Aqara Hub M2 and Mi Control Hub gateways - all methods work, but require exact follow-up instructions. If you have already tried to connect and received an error like "Device is not supported" or "Can not add", do not close the page: there is a section in the article with solutions for such cases.

So we're going to start tweaking it Step-by-step, from the gateway preparation to the final synchronization with Alice, and it's going to take no more than 20 minutes if you follow the manual without missing a pass.

1. Preparing Xiaomi Gateway for Integration

Before Alice is connected, the gateway must be properly configured in the Xiaomi ecosystem, and missing this stage is the main cause of synchronization errors, starting with checking the current state of the device.

Make sure that:

  • πŸ”Ή Gateway connected to 2.4 GHz network (5 GHz not supported by most models).
  • πŸ”Ή The device is added to the Mi Home app (or Aqara Home for the Aqara line) and appears in the list of All Devices".
  • πŸ”Ή Xiaomi’s account region is set to β€œChina” (for some models) or β€œRussia” (for officially localized devices).
  • πŸ”Ή The Gateway firmware version is relevant (update to Settings) β†’ About the device β†’ Update of the PO).

If the gateway has been used with another account before, reset to factory settings.

  1. Shut off the airlock power.
  2. Press the reset button (usually located on the back) and hold for 10-15 seconds until the indicator starts flashing yellow.
  3. Connect the power back and wait for the reset (the indicator blinks blue).

πŸ’‘

If the gateway does not appear in Mi Home after reset, try connecting to its temporary Wi-Fi network (the name begins with lumi-gateway-) and repeat the addition.

2. Set up Xiaomi account for synchronization

Yandex.Smart Home interacts with Xiaomi devices via the Mi Home cloud, so it is critical to set up an account correctly. Errors at this stage lead to problems such as "Device is unresponsive" or "No access."

Follow the checklist:

β˜‘οΈ Preparation of Xiaomi account

Done: 0 / 5

Pay special attention to the region of the account:

  • 🌍 For Mi Gateway 3, Aqara Hub M2 and other gray devices, choose China (China).
  • πŸ‡·πŸ‡Ί For officially supplied to Russia gateways (for example, Mi Control Hub) – Russia (Russia).

If the region is incorrect, the gateway will not be visible in Yandex.Smart Home even after the successful addition to Mi Home.

Profile β†’ Settings β†’ Country / Region
πŸ“Š What kind of Xiaomi gateway do you use?
Mi Gateway 3
Aqara Hub M2
Mi Control Hub
Other (specify in the comments)

3. Adding a gateway to Yandex.Smart Home

Now, to the main stage, the gateway link to Alice, there are two scenarios: automatic (for supported models) and manual (through third-party services).

Method 1: Automatic synchronization (officially supported devices)

If your gateway is on the list of compatible Yandex devices, follow the steps:

  1. Open the Yandex app with Alice tied up.
  2. Go to a smart home β†’ Add a device β†’ Xiaomi
  3. Enter the username/password from the Mi Home account (confirmation via SMS is required).
  4. Select the gateway from the list of available devices and confirm the addition.

The process will take 1-2 minutes. After successful synchronization, the gateway will appear in the list of devices Yandex.Smart Home with voice control.

Method 2: Manual integration via Home Assistant (for unofficial devices)

If your gateway model isn’t officially supported (like the Aqara Hub E1 or older Mi Gateway versions), use the Home Assistant intermediate server.This method takes longer, but works for 90% of Xiaomi devices.

Instructions:

  1. Install Home Assistant on Raspberry Pi, NAS or PC (instructions on the official website).
  2. Add Xiaomi Mi Home integration through Settings β†’ Devices and Services β†’ Add Integration.
  3. Enter the data from your Mi Home account (the region must match the gateway settings!).
  4. Configure the Home Assistant bundle with Yandex.Smart Home via Yandex Smart Home (requires a token from Yandex).
How to get a token for Yandex.Smart Home?
1. Go to the https://oauth.yandex.ru/authorize?response_type=token&client_id=... (full-fledged URL See the Home Assistant documentation). 2. Log in and copy the token from the address bar (after #access_token=). 3. Insert the token into the Yandex Smart Home integration settings in Home Assistant.

4. Solving typical connection errors

Even with the correct following of the instructions, errors can occur. We have collected the TOP-5 problems and ways to fix them:

Mistake.Reason.Decision
The device is not supportedThe gateway is not included in the official list of compatible devices of Yandex.Use Home Assistant or check the Xiaomi account region.
Couldn't add the device.Unstable Internet connection or Xiaomi cloud lockReconnect the gateway to the network, disable the VPN/proxy, try again.
Offline deviceThe gateway is not connected to Xiaomi servers.Reboot the gateway, check the internet and region in Mi Home.
Authentication errorIncorrect login/password or two-factor authorization enabled.Turn off 2FA in Mi Home while you add it or use the app password.
The device does not respond to commandsConflict with other smart systems (Google Home, Apple HomeKit)Remove the gateway from other ecosystems and reconnect only to Yandex.

Critical detail: If the gateway was previously linked to an account in the China region and then the region was changed to Russia, the device may disappear from the Mi Home, in which case a complete reset of the gateway and re-addition is required.

5.Setting up voice control via Alice

Once the gateway is successfully connected, it remains to configure voice commands. Alice supports basic scripts for Xiaomi, but advanced management requires creating routines.

Examples of work teams:

  • πŸ”¦ "Alice, turn on the light in the hallway (if you have Yeelight or Xiaomi Smart Bulb lamps connected to the gateway).

To create custom scenarios:

  1. Open Yandex β†’ Smart Home β†’ Scenarios β†’ Create a script.

πŸ’‘

Alice only recognizes devices that appear in the Smart Home section of the Yandex app. If the gateway is in Mi Home but is not in Yandex, check the synchronization settings.

6. Optimizing the lock with Alice

To avoid delays in execution of commands and failures, follow the recommendations:

For stable operation:

  • πŸ“Ά Place the gateway at a distance of no more than 10 meters from the router (obstacles like walls reduce the range of Zigbee).
  • πŸ”„ Update the gateway firmware every 1-2 months (new versions are notified in Mi Home).
  • πŸ”Œ Use the original power supply (unstable voltage can cause failures).
  • πŸ›‘οΈ Turn off the energy-saving mode for the gateway in the router settings (if there is such an option).

For enhanced opportunities:

  • πŸ€– Connect the gateway to Google Assistant or Apple HomeKit via Home Assistant for cross-platform management.
  • πŸ“Š Use Node-RED to create complex automations (e.g., bundling motion sensors with lighting).
  • πŸ”§ Set up local management (no cloud) to reduce latency (requires Home Assistant).

πŸ’‘

If Alice stops responding to commands, try untethering and re-linking Xiaomi account to Yandex.Smart Home. This resets the sync cache.

7.Security: How to protect the gateway from hacking

Xiaomi's Internet-connected gateways could be a target for hackers, especially devices with outdated firmware or weak passwords.

Basic measures:

  • πŸ” Set a complex password for your Mi Home account (at least 12 characters with numbers and special signs).
  • πŸ”„ Enable two-factor authentication in Xiaomi profile settings.
  • 🌐 Change the standard. SSID and the gateway's Wi-Fi network password (if it gives away its own network).

Additional protection:

  • πŸ›‘οΈ Set up network segmentation on the router so that the gateway is on a separate subnet (VLAN).
  • πŸ” Regularly check the list of connected devices in Mi Home for unknown gadgets.
  • 🚫 Disable remote access to the gateway in the Mi Home settings if you do not use external control.

⚠️ Note: If you use Aqara Hub with HomeKit, never share a HomeKit code (8-digit). PIN It gives you full access to your smart home.

FAQ: Frequent questions on connecting Xiaomi gateway to Alice

My Xiaomi gateway doesn't appear in the Yandex.Smart Home list of devices.
Check: Xiaomi account region (should be China for most models), gateway in the list of supported devices, Internet connection stability (gateway should be online in Mi Home), if the problem remains, use Home Assistant as an intermediate server.
Alice says "Device is not responding," even though the gateway is connected.
Causes: Gateway overheated or malfunctioned (check the indicators); Xiaomi or Yandex servers are temporarily unavailable (check statuses on Downdetector); conflict IP-Network addresses (reboot router) Solution: reboot gateway and router, wait 5-10 minutes and repeat command.
Can I connect to Alice the Xiaomi gateway without Home Assistant?
Yes, but only if the gateway model is officially supported by Yandex, the full list of compatible devices is available here, and for informal devices (such as the Aqara Hub E1) Home Assistant remains the only working solution.
How to reset the Xiaomi gateway if it does not respond to a reset button?
Alternatively, turn off the power. Press the reset button and hold it, power it up. Hold the 30 to 40 second button until the indicator flashes red quickly. Release the button and wait for the reset (the indicator to turn blue). If that doesn't work, the gateway may malfunction (repair required).
Does Alice support Cyrillic device names in teams?
Yes, but with reservations: Device names in Mi Home should be in Russian (e.g., "Lamp in the hall" rather than "Living room light"). Use simple names without special symbols (Alice does not recognize "Lamp #1" or "Light kitchen"). For reliability, duplicate the name in Latin in brackets (e.g., "Lamp (Lamp)").