miclaw在哪里使用？Xiaomi miclaw使用方法

Xiaomi MiClaw 是一款专为小米 HyperOS 架构设计的端侧 AI 智能体（Agent）底层框架。其核心价值在于提供系统级的接口抽象层，将大语言模型（LLM）的逻辑推理物理转化为对小米手机、平板终端应用及局域网米家 IoT 设备的自动化协同控制指令。

本文大纲

• 📱 宿主环境与物理部署：HyperOS 系统级权限与 ADB 调试模式的挂载

• 🔌 本地网关与生态总线：米家 IoT 设备的协议映射与局域网控制

• ⚙️ 自动化工作流配置：miclaw.yaml 路由文件与技能注册

• ⚠️ 唤醒链路与系统边界：小爱同学的端侧接管与风控拦截变量

1. 宿主环境与物理部署 📱

MiClaw 的运行环境高度绑定于小米的底层系统架构，部署的物理前提是获取设备端的特定开发者权限。

• 系统前提：宿主机必须运行 HyperOS 1.0 或以上版本。由于涉及深度的系统 UI 自动化（如跨应用流转与屏幕点击），该框架不支持非小米阵营的 Android 设备。

• 部署路径：

  必须在设备的“开发者选项”中显式开启 USB 调试（安全设置） 与 无线调试。随后通过电脑终端或本地 Termux 环境执行安装与提权注入：

  Bash

   

  adb connect 127.0.0.1:5555
  adb shell pm install -r -g /sdcard/Download/miclaw-service.apk
  

简要解释：-g 参数变量用于在安装时自动向核心服务包授予所有的运行时物理权限，确保自动化工作流不会被系统的隐私沙箱弹窗物理阻断。

2. 本地网关与生态总线 🔌

MiClaw 在物联网场景下的执行优势在于其局域网直连机制。

• 协议桥接：它默认不通过云端的米家 API 进行数据路由，而是直接监听并映射局域网内的 MIOT 协议（Xiaomi IoT Protocol）。

• 网关启动：在端侧运行后台守护进程后，该设备即成为边缘控制中枢，默认在局域网内暴露 8080 端口接收上游的意图变量。

• 执行链路：当 LLM 输出包含设备操作的 JSON 指令后，本地网关会将其解包并转化为对特定智能家居设备（如路由、灯控、中枢网关）的 UDP/TCP 本地广播报文。

3. 自动化工作流配置 ⚙️

定义系统级 Agent 能力的物理边界，依赖于对核心路由文件的结构化配置。

• 文件挂载：设备内部存储中的 /sdcard/MiClaw/miclaw.yaml 是整个调度逻辑的控制中枢。

• 变量声明：需在该文件中配置底层算力的鉴权端点（例如调用端侧的 MiLM 量化模型或公有云大模型），并注册允许框架调用的系统动作（如 screen_capture, app_launch, iot_control）。

  YAML

   

  llm:
    provider: "xiaomi_cloud"
    model: "mi-lm-pro"
    api_key: "你的_开放平台_TOKEN"
  
  skills:
    - name: "mijia_control"
      allow_devices: ["light.livingroom", "airconditioner.bedroom"]
  

4. 唤醒链路与系统边界 ⚠️

在触发交互与指令下发阶段，存在严苛的系统权限阻断机制。

• 语音链路接管：为实现无缝的自然交互，可在配置中声明 voice_hijack: true 变量，将系统原生“小爱同学”的唤醒信号在系统底层重定向至 MiClaw 的输入端点。

• 风控拦截：当生成的 JSON 动作涉及唤起支付组件、读取密码本或系统级高危覆写操作时，HyperOS 会在底层直接抛出 Permission Denied 阻断执行链路，此类权限无法通过常规 ADB 命令绕过。

总结

本文拆解了小米 MiClaw 框架在 HyperOS 系统下的部署与交互逻辑。该框架通过安装具备系统级权限的服务包，实现了对终端应用与米家设备的本地自动化控制。其核心运转依赖于 miclaw.yaml 中的鉴权与技能注册，并严格受限于操作系统的底层隐私风控机制。