| name | miloco-overview |
| description | Xiaomi Miloco 米家智能家居能力总览与适配说明。当用户提到米家/小米设备、家庭场景、家人身份、家庭事件/告警、自动化/任务、家庭档案/习惯、感知范围、主动通知时加载本 skill,了解 Miloco 全部能力以及它们在 SSR 中对应的 miloco_* 工具。 |
| metadata | {"author":"ssr-miloco","version":"1.0"} |
Miloco 能力总览(SSR 适配)
SSR 通过原生集成 Xiaomi Miloco 接入米家。
本仓库已把 Miloco 官方 plugins/skills 下的全部技能文档纳入知识库(miloco-*
skills),它们描述了 Miloco 的完整能力与判断逻辑。
重要适配说明:官方技能是为 OpenClaw 写的,正文里大量使用 miloco-cli ...
命令行。在 SSR 中:
- 优先使用下面的
miloco_* 工具(直接走 Miloco 的本地 REST API,无需 miloco-cli)。
- 仅当环境里确实安装了
miloco-cli(例如与 Miloco 同机)时,才用 run_command
执行官方技能里的 miloco-cli 命令;在 ssr-miloco 的 Docker 部署里 ssr 容器没有
miloco-cli,请一律用 miloco_* 工具。
- 把官方技能当作「能力说明书 + 判断准则」来读,把其中的
miloco-cli <子命令>
映射成对应的 miloco_* 工具调用。
能力 → SSR 工具映射
| Miloco 能力(官方 skill) | SSR 工具 |
|---|
| 连通性 / 账号绑定 / 运维(miloco-miot-admin) | miloco_status、miloco_refresh |
| 设备查询/控制(miloco-devices) | miloco_devices、miloco_device_status、miloco_device_spec、miloco_device_control |
| 触发场景(miloco-devices 场景部分) | miloco_trigger_scene |
| 摄像头列表 | miloco_cameras |
| 家庭成员档案 CRUD(miloco-miot-identity) | miloco_family(读取;增删改名走 Miloco 端) |
| 身份样本注册/录脸(miloco-miot-identity-register) | 需上传图像,走 Miloco 端/ miloco-cli(SSR 暂只读 miloco_family) |
| 家庭事件/感知回顾(miloco-perception, events) | miloco_activities,并订阅总线 miloco.activity.** |
| 自动化规则(rule) | miloco_automations |
| 持续家庭任务(miloco-create-task, terminate-task) | miloco_tasks(读取;增删走 Miloco 端) |
| 家庭档案/长期记忆(miloco-home-profile, habit-suggest) | miloco_home_profile |
| 感知范围:家庭/摄像头(miloco-miot-scope) | miloco_scope |
| 主动通知 TTS/IM/米家推送(miloco-notify) | miloco_notify(也可用 SSR 自带 push_notification) |
| 一次性快照进上下文 | miloco_sync(设备/摄像头/成员/事件/规则/任务/家庭档案/感知范围) |
事件驱动(总线)
Miloco 的家庭事件(Activity)会被 SSR 桥接为总线事件
miloco.activity.<type>。要「当家里发生 X 时自动做 Y」,用 bus_create_handler
订阅 miloco.activity.**(或更具体的子主题),在处理器里调用上面的工具或
push_notification 主动触达。
未覆盖/受限能力(需 Miloco 端或 miloco-cli)
- 身份样本注册(录脸/录身形):需要上传图像/视频帧,SSR 暂未封装,请走
Miloco 仪表盘或
miloco-cli(见 miloco-miot-identity-register skill)。
- 成员/任务/规则/家庭档案的写操作:SSR 目前以读取 + 设备控制 + 触发场景 +
主动通知为主;档案写入、任务创建/删除、规则增删请走 Miloco 端能力(官方 skill
里的
miloco-cli 命令)或后续在 SSR 中补充对应工具。