小米 MiLoco 本地协同智能助手部署实战

网络模式配置

在系统中搜索 WSL Setting，将网络模式修改为 Mirrored。修改后需使用 wsl --shutdown 停止子系统，重新运行 wsl -d Ubuntu-24.04 进入，输入 ip a 检查网络配置是否与宿主一致。

设置为 Mirrored 模式后，需配置 Hyper-V 防火墙允许入站连接。在 PowerShell 窗口中以管理员权限运行以下命令：

Set-NetFirewallHyperVVMSetting -Name '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -DefaultInboundAction Allow

（2）Docker 环境

在 WSL2 中推荐使用官方脚本安装：

curl -fsSL https://get.docker.com | bash -s docker
# 国内用户可指定 Aliyun 源
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

将当前用户加入 docker 组以便直接使用命令：

sudo usermod -aG docker $USER

添加完成后需重新登录使更改生效，使用 docker --version 验证。

（3）显卡驱动及开发工具

推荐安装 CUDA Toolkit：

wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt-get update
sudo apt install nvidia-cuda-toolkit
sudo apt-get -y install cuda-drivers

或者配置 NVIDIA Container Toolkit：

sudo apt-get update && sudo apt-get install -y --no-install-recommends curl gnupg2
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
export NVIDIA_CONTAINER_TOOLKIT_VERSION=1.18.0-1
sudo apt-get install -y nvidia-container-toolkit=${NVIDIA_CONTAINER_TOOLKIT_VERSION} nvidia-container-toolkit-base=${NVIDIA_CONTAINER_TOOLKIT_VERSION}

3. 环境验证

验证 Docker

docker run hello-world
# 显示 Hello from Docker! 即成功，之后可移除镜像
docker rmi hello-world

验证 NVIDIA 显卡驱动

nvidia-smi
nvcc --version

验证 NVIDIA Container Toolkit

docker run --rm --gpus all nvidia/cuda:12.4.0-base-ubuntu22.04 nvidia-smi

4. 安装与启动

下载源码后执行一键安装脚本：

git clone https://github.com/XiaoMi/xiaomi-miloco.git
cd xiaomi-miloco
bash scripts/install.sh

运行界面会提示选择安装方式，选择 "1. Quick Install"。

下载路径建议选择国内节点如 Xiaomi FDS。

安装完成后会有提示，随后启动服务。

5. 前端访问

通过 https://<your ip>:8000 访问服务。本机访问 IP 为 127.0.0.1。

注意：

• 请使用 https 访问，而非 http。
• Windows 下可直接尝试访问 WSL 的 IP 地址。
• macOS 环境下若网络模式为桥接，请使用 Docker 所在虚拟机的 IP。

6. 使用指南

前端管理界面提供模型设置与规则管理功能。

设置后端模型：在界面中选择对应的后端模型。

设置规则：主界面可自动生成，也可在规则管理里手动添加。添加前需在米家 APP 内测试设备控制有效性。设置时务必点击'测试'按钮生成有效指令，因为 AI 模型生成的指令可能需要多次调试。

若规则执行有问题，可在日志管理中查看相关执行日志。