Xiaomi Token 提取器：小米设备令牌提取工具

项目简介

Xiaomi-cloud-tokens-extractor 是一个 Python 编写的命令行工具，用于从小米云中读取当前账号下所有已连接设备的 token，以及 BLE 设备的加密密钥。登录后工具会要求选择小米服务器区域（如 cn 代表中国、de 代表德国等），留空则检查所有可用区域。

运行完成后，工具会列出账号下连接的全部设备，并同时给出设备名称与 IP 地址。常见用途是配合 Home Assistant 等平台接入小米设备（如扫地机器人）时填写所需的 token。

主要功能

• 提取小米云账号下所有设备的 token
• 提取 BLE 设备的加密密钥
• 输出设备名称与 IP 地址
• 支持两种认证方式：用户名（邮箱 / 小米云账号 ID）加密码，或二维码登录
• 可选择指定服务器区域，或留空检查全部区域

安装与使用

Windows

下载并运行 token_extractor.exe。

Linux 与 Home Assistant（在 SSH & Web Terminal 中）

bash <(curl -L https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/raw/master/run.sh)

如果安装失败，可以尝试 Docker 版本。

Docker 与 Home Assistant（在 SSH & Web Terminal 中）

bash <(curl -L https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/raw/master/run_docker.sh)

在 Home Assistant 中运行该命令前，需要在插件设置里关闭 protected mode 并重启插件。

使用 Python 手动运行

下载并解压压缩包：

wget https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/releases/latest/download/token_extractor.zip
unzip token_extractor.zip
cd token_extractor

安装依赖并运行脚本：

pip3 install -r requirements.txt
python3 token_extractor.py

注意事项

如果工具无法正常使用，可以尝试以下排查方式：

• 确认填写的账号密码正确（例如不要使用 Roborock App 的账号）
• 移除 Cloudflare DNS
• 关闭网络广告拦截（AdGuard、PiHole 等）与网络限制（UniFi Country Restriction 等）
• 检查垃圾邮件文件夹，看是否有 2FA 验证邮件
• 改用二维码认证代替用户名密码登录
• 耐心等待：2FA 请求每天存在次数限制（按区域不同为 3 次或 5 次）

相关工具：作者还提供 Map extractor（小米扫地机器人实时地图）与 Map card（在 Lovelace 卡片中手动控制扫地机器人）。

---

本作品整理自 GitHub 开源项目 PiotrMachowski/Xiaomi-cloud-tokens-extractor，原作者 @PiotrMachowski，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。