ghcr.io/xiaomi/miloco-backend:latest

Xiaomi Miloco

English | 简体中文

小米面向未来全屋智能的开源AI解决方案。它将米家摄像头的音视频作为全模态感知入口，内置的MiMo大模型作为智能大脑，并作为Agent插件运行在OpenClaw之上，协调全屋设备以提供主动、智能的体验。

Miloco 2.0能够感知家中发生的情况，基于常识做出主动决策并控制设备，将“模糊且长期”的目标分解为可追踪的家庭任务，识别家庭成员，并借助家庭记忆为每位成员提供个性化服务：查询和控制设备、将家居环境调整到符合成员的舒适度，或在合适的时机提供有用的提醒。

What's New

• 2026-07-03 — 发布 v2026.7.3：新增事件反馈打包和对话式首次运行设置，在全新安装时主动启动；此外改进了仪表板内的模型配置管理、感知稳定性（防误检“人员”功能）、摄像头生命周期和CLI诊断。
• 2026-06-18 — Miloco 2.0 正式发布：重构为OpenClaw插件，新增通用常识、身份识别、家庭记忆、家庭任务、主动智能和家庭仪表板。详见下文核心功能。

Core Features

• 通用常识 — 无需预设规则。内置常识可自动检测危险并发出分级警报（例如儿童玩刀、老人跌倒）。
• 身份识别 — 融合人脸、体态等身份信号，通过大模型识别家庭成员。支持主动注册新成员及基于身份的个性化操作。
• 家庭记忆 — 从感知和交互中提取家庭成员的长期习惯与偏好，作为Agent做出主动决策时的参考。稳定的长期习惯还可触发主动提醒或升级为自动执行的家庭任务。
• 家庭任务 — 从单一“条件触发规则”升级为复杂、长期运行的家庭任务：条件自动化（“有人进入时开灯”）、定时提醒（“每天提醒我吃药”）、习惯追踪（“每天锻炼半小时”）等。触发后，Agent理解意图并自主执行。
• 主动智能 — 基于通用常识、身份识别、家庭记忆和家庭任务四大基础能力，系统像一位具备常识、了解家人且能提前规划的管家，适时观察、推理并介入，在用户开口前完成任务。
• 家庭仪表板 — 面向用户的Web仪表板，用于查看家庭实时概况、米家设备、家庭成员及资料，以及过往事件历史。

培养你自己的Miloco。其开箱即用的行为可能并不总是符合你的喜好——只需通过OpenClaw告诉Miloco（例如“家里乱的时候不要提醒我”），它会记住你的偏好并调整主动行为。每一次反馈都在“培养”一个适应你家的Miloco，相处越久，它就越了解你。

Prerequisites

• 硬件：推荐≥4GB内存和≥256GB存储，需24/7运行。推荐使用Mac mini。
• 操作系统：macOS / Linux（Windows需在WSL下运行）。
• OpenClaw — Miloco作为插件运行其上，因此需先安装版本≥2026.5.2的OpenClaw。
• 小米账号 + 已添加至米家的设备。
• 多模态大模型API密钥 — 推荐使用小米MiMo：感知功能使用MiMo-v2.5，Agent功能使用MiMo-v2.5-pro（在OpenClaw中配置）。

[!IMPORTANT] 成本说明：Miloco 2.0的感知和Agent主要依赖云端大模型，会产生持续的API使用成本——请注意监控用量。你可以在家庭仪表板的“模型”页面查看令牌消耗情况。

项目仓库 README（补充）

Xiaomi Miloco

English | 简体中文

小米 Miloco 是面向未来全屋智能的开源 AI 解决方案。它将米家摄像头的音视频作为全模态感知入口，以自研 MiMo 大模型为智能大脑，并作为 Agent 插件运行在 https://openclaw.ai 之上，实现全屋设备的协同调度，提供主动智能体验。

Miloco 2.0 能够感知家中发生的情况，基于常识主动决策并控制设备，将“模糊且长期”的目标分解为可追踪的家庭任务，识别家庭成员，并借助家庭记忆为每位成员提供个性化服务：查询和控制设备、调整家居环境至舒适状态，或在恰当的时刻提供有用的提醒。

What's New

• 2026-07-03 — 发布 v2026.7.3：新增事件反馈打包和对话式首次运行设置（全新安装时主动启动）；优化了仪表盘中的模型配置管理、感知稳定性（防误识“人员”检测）、摄像头生命周期及 CLI 诊断功能。
• 2026-06-18 — Miloco 2.0 正式发布：重构为 OpenClaw 插件，新增通用常识、身份识别、家庭记忆、家庭任务、主动智能及家庭仪表板。详见下方核心功能。

Core Features

• 通用常识 — 无需预设规则。内置常识可自动检测危险并发出分级警报（例如儿童玩刀、老人跌倒）。
• 身份识别 — 融合人脸、体态等身份信号，通过大模型识别家庭成员。支持主动注册新成员及基于身份的个性化操作。
• 家庭记忆 — 从感知和交互中提炼家庭成员的长期习惯与偏好，作为 Agent 主动决策时的参考。稳定的长期习惯还可触发主动提醒或升级为自动执行的家庭任务。
• 家庭任务 — 从单一的“条件触发规则”升级为复杂、长期运行的家庭任务：条件自动化（“有人进入时开灯”）、定时提醒（“每天提醒我吃药”）、习惯追踪（“每天锻炼半小时”）等。触发后，Agent 理解意图并自主执行。
• 主动智能 — 基于通用常识、身份识别、家庭记忆和家庭任务四大基础能力，系统能够像一位懂常识、了解家人且有规划的管家一样，适时观察、推理并干预，在用户开口之前就完成任务。
• 家庭仪表板 — 面向用户的 Web 仪表板，用于查看家庭实时概况、米家设备、家庭成员及档案，以及过往事件历史。

[!NOTE] 培养专属 Miloco。Miloco 的默认行为可能并不总能符合您的喜好——只需通过 OpenClaw 告诉 Miloco（例如“家里乱的时候不要提醒我”），它会记住您的偏好并调整主动行为。每一次反馈都在“培养”一个适应您家庭的 Miloco，相处时间越长，它就越了解您。

Prerequisites

• 硬件：推荐配置 ≥ 4GB 内存和 ≥ 256GB 存储，需 24/7 运行。推荐使用 Mac mini。
• 操作系统：macOS / Linux（Windows 需在 WSL 下运行）。
• OpenClaw — Miloco 作为插件运行在其之上，因此需先[***] ≥ 2026.5.2 的 OpenClaw。
• 小米账号 + 已添加至米家的设备。
• 多模态大模型 API 密钥 — 推荐使用小米 MiMo：感知功能使用 MiMo-v2.5，Agent 使用 MiMo-v2.5-pro（在 OpenClaw 中配置）。

[!WARNING] 成本说明：Miloco 2.0 的感知和 Agent 主要依赖云端大模型，会产生持续的 API 使用成本——请注意您的使用量。您可以在家庭仪表板的“模型”页面查看令牌消耗情况。

Install

选项 1：通过 Agent 安装（推荐）

向 OpenClaw 发送以下指令以自动完成安装：

Please install the Miloco plugin for me: https://raw.githubusercontent.com/XiaoMi/xiaomi-miloco/main/scripts/install-guide.md

选项 2：单行命令行安装

curl -LsSf https://github.com/XiaoMi/xiaomi-miloco/releases/latest/download/install.sh | bash

选项 3：从源码构建

从项目根目录运行：

bash scripts/install.sh --dev # build from source (scripts/build.sh), then install locally

---

Windows（WSL）

无论选择上述哪种方法，均不支持原生 Windows——请在 WSL 中安装并运行所有内容。

[!IMPORTANT] 本地摄像头流需要额外的WSL网络设置。 仪表板的“实时家庭视图”通过局域网拉取摄像头流，而WSL的默认NAT模式会阻止摄像头发送的UDP数据包——因此在启用镜像网络并允许Hyper-V防火墙之前，视频流将无法加载。

1. 在Windows上 — 将以下内容添加到%USERPROFILE%\.wslconfig（即C:\Users\<用户名>\.wslconfig；若文件不存在则创建），然后在PowerShell中运行wsl --shutdown重启WSL：

[wsl2]
networkingMode=mirrored

2. 在Windows（提升权限的PowerShell）上 — 允许入站流量到WSL：

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

3. 在WSL中 — 安装Miloco后，使用miloco-cli doctor验证（该命令会检查防火墙和WSL网络配置）。

快速开始

安装完成后，重启OpenClaw网关使插件生效：

openclaw gateway restart

然后打开家庭仪表板完成初始设置：

miloco-cli dashboard # 在浏览器中打开家庭仪表板（或直接访问 http://<IP>:1810/）

通过仪表板的三个步骤开始使用：

1. 配置模型 — 在“模型”页面，输入MiMo的api_key（若安装时已填写则跳过）。模型名称和Base URL默认设为MiMo，无需修改。
2. 绑定小米账号 — 账号绑定后，米家设备将自动同步。
3. 启用摄像头感知 — 在“概览”页面，打开需要感知的摄像头开关（未开启的摄像头不会被分析）。

也可通过命令行完成上述操作：

miloco-cli config set model.omni.api_key sk-xxx # 配置模型密钥（默认使用MiMo；通常只需此步骤）
miloco-cli account bind # 绑定小米账号
miloco-cli scope camera enable <摄像头ID> # 为特定摄像头启用感知功能

运行后，请参阅用户手册了解Miloco的日常使用方法。

项目结构

miloco-plugin/
├── backend/ # uv工作区
│ ├── miloco/ # 主服务：感知引擎、规则、MIoT网关
│ └── miot/ # MIoT SDK（独立子包）
├── cli/ # miloco-cli命令行工具
├── plugins/
│ ├── openclaw/ # OpenClaw插件（TypeScript）
│ └── skills/ # 智能体技能文档
├── web/ # 家庭仪表板（React 19 + Vite）
├── scripts/ # build.sh / install.sh / manifest.json
└── knowledge/ # 项目知识库

更多文档

• 后端服务 — FastAPI + 感知引擎 + 规则 + MIoT网关
• 命令行工具miloco-cli — 服务、设备和配置管理
• 家庭仪表板Web端 — 部署架构和本地开发
• 完整知识库 — 架构/模块/功能/API快速参考

社区

遇到问题、想提供反馈或交流使用场景？扫描***加入飞书用户群（***永久有效）：

致谢

Miloco的开发基于以下开源项目：

• https://openclaw.ai — AI智能体运行时和插件平台
• https://github.com/samirkumardas/jmuxer%EF%BC%88MIT%E8%AE%B8%E5%8F%AF%EF%BC%89%E2%80%94 家庭仪表板的实时视频流复用
• https://huggingface.co/BAAI/bge-small-zh-v1.5%EF%BC%88BAAI%EF%BC%8CMIT%E8%AE%B8%E5%8F%AF%EF%BC%89%E2%80%94 文本嵌入模型
• https://github.com/snakers4/silero-vad%EF%BC%88Silero%E5%9B%A2%E9%98%9F%EF%BC%8CMIT%E8%AE%B8%E5%8F%AF%EF%BC%89%E2%80%94 语音活动检测，用于感知语音区域的门控

许可协议

完整许可条款见LICENSE.md。

重要声明：本项目仅用于非商业用途。未经小米公司书面授权，不得用于开发应用程序（apps）、网络服务或其他形式的软件。