Xiaomi Miloco 完整部署指南：一条命令装好，三步跑起家庭智能管家

Xiaomi Miloco 完整部署指南一条命令装好三步跑起家庭智能管家【免费下载链接】xiaomi-milocoXiaomi Miloco项目地址: https://gitcode.com/gh_mirrors/xi/xiaomi-milocoXiaomi Miloco 是小米开源的全屋智能 AI 方案以米家摄像头的画面与声音为感知入口以 MiMo 多模态大模型为大脑替你主动观察家、判断并操控设备。本文带你完成 Xiaomi Miloco 部署一条命令安装、验证成功、填好关键配置再按需做进阶优化全程可照着做。部署前确认硬件与软件要求先对照这张表确认你的机器达标能省掉后面大量排障时间项目最低要求推荐操作系统macOS / LinuxWindows 需在 WSL 中运行Mac mini 或小型主机7×24 常驻内存4GB8GB 以上存储256GB512GB会持续积累事件截图与日志Agent 运行时OpenClaw ≥ 2026.5.2Miloco 以插件形式运行其上保持最新版账号与密钥小米账号 至少 1 台米家设备 MiMo API Key—显卡无需独立显卡—感知走云端 VLM 本地 ONNXCPU 即可Xiaomi Miloco 家庭面板「概览」页家中实时状态、摄像头卡片与设备一览部署成功后从这里开始配置最快上手路径Miloco 一键安装命令 整条安装链只有三行命令git clone https://gitcode.com/gh_mirrors/xi/xiaomi-miloco cd xiaomi-miloco bash scripts/install.sh前两条命令拉取代码并进入目录。第三条执行安装脚本它会依次完成环境检查 → 安装后端与 CLI → 引导绑定米家账号 → 填入 Omni 模型密钥 → 下载感知模型 → 安装 OpenClaw 插件。全程按提示回答即可想直接用克隆的源码跑在命令后加--dev参数。装完重启网关并打开面板openclaw gateway restart miloco-cli dashboard✅怎么算装成功了跑这两条验证miloco-cli service status curl http://127.0.0.1:1810/health # 返回 {status:ok} 即成功看到 ok 后在面板里三步完成首次配置「模型」页填 MiMo Key安装时已填可跳过→绑定小米账号自动拉取米家设备→在「概览」页打开要感知的摄像头开关。绑定小米账号后「设备」页按房间展示米家设备可直接点击控制核心配置讲解必须动的 3 个 config.json 字段⚙️ 所有用户配置都写在~/.openclaw/miloco/config.json即$MILOCO_HOME/config.json用 CLI 改最省事不用手编辑文件配置项改哪个字段改成什么什么时候要改模型密钥model.omni.api_key你的 MiMo Key首次部署必改感知引擎靠它启动局域网访问server.host0.0.0.0默认127.0.0.1仅本机想在别的设备浏览器里打开面板时服务端口server.port如1811默认1810端口被其他服务占用时miloco-cli config set model.omni.api_key 你的MiMoKey miloco-cli config set server.host 0.0.0.0 miloco-cli config set server.port 1811改完重启一次让配置生效miloco-cli service stop miloco-cli service start「模型」页管理 Omni 模型档案与 Token 用量是部署后最常访问的配置入口进阶优化省 token、护磁盘、生产化按想提升什么 → 改哪里对照即可不需要全做。想省模型费用与负载调低 Omni 帧率每次摄像头画面有变化都会调用大模型调用越多 token 花得越快。在面板「模型」页调整omni_fps送模型的帧率支持热更新、无需重启默认值定义在backend/miloco/src/miloco/config/settings.yaml的perception.engine段fps: 3、omni_fps: 1家庭活动少时把omni_fps调得更低即可。想防止磁盘被写满设截图配额、关采样两行配置解决miloco-cli config set perception.snapshot_max_disk_mb 2048 # 事件截图磁盘上限(MB) miloco-cli config set perf.enabled false # 关闭性能采样不再写 observability.db想远程访问并加密开 LAN 反向代理后端固定走 HTTP跨网加密靠反向代理。把server.host改为0.0.0.0后用 nginx 加一张正式证书反代到127.0.0.1:1810对外只暴露 443 端口同时自行评估家庭网络边界面板地址内嵌访问令牌能访问首页即能调 API。想重启后自动拉起服务服务本身是miloco-cli service管理的后台守护进程supervisord。把下面这行加进你的 crontabcrontab -e机器重启后自动恢复reboot miloco-cli service start快速排障3 个高频问题的排查链️ 每个问题都按先看什么 → 再执行什么走别跳步。1. 摄像头拉流失败、画面一直等待码流先看运行miloco-cli doctor它会逐台摄像头做网段 → 路由 → ping → UDP 的分层探测直接告诉你断在哪一环。再执行绝大多数是防火墙拦了摄像头主动发来的 UDP 包。Ubuntu/Debian 上放行家庭网段按你实际网段调整sudo ufw allow from 192.168.0.0/16 proto udp2. 服务起不来报port already in use先看miloco-cli service status确认状态再ss -tlnp sport :1810找出谁占了端口。再执行按上文改server.port换端口然后miloco-cli service stop miloco-cli service start。3. 感知引擎不启动、Omni 调用失败先看miloco-cli config get model.omni.api_key为空时引擎会停在no_omni_api_key等待态此时设备控制等其他功能不受影响。再执行miloco-cli config set model.omni.api_key 你的MiMoKey miloco-cli service stop miloco-cli service start「日志」页回放今日有价值事件排障后可在这里确认感知数据已正常沉淀下一步去哪看装好之后怎么用控制设备、建规则、注册家庭成员使用说明书每个模块的设计与数据流知识库索引更完整的故障现象与错误码速查故障排查手册 部署遇到问题先跑miloco-cli doctor——网络与配置类问题它都能一次定位到具体环节。【免费下载链接】xiaomi-milocoXiaomi Miloco项目地址: https://gitcode.com/gh_mirrors/xi/xiaomi-miloco创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考