Back to search
mijia-device-manager
SkillGitHub
管理和控制小米/米家智能家居设备的SIKIL,兼容claude code或openclaw等agent,支持设备发现、开关控制、亮度调节、颜色设置等功能。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/dean2021--mijia-device-manager)HTML
<a href="/listings/dean2021--mijia-device-manager"><img src="/api/listings/dean2021--mijia-device-manager/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 154 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: mijia-device-manager
- description: 管理和控制小米/米家智能家居设备,直接调用 mijiaAPI CLI 命令通过小米云端 API 控制设备。支持设备发现、开关控制、亮度调节、颜色设置等功能。当用户需要控制小米智能设备(如台灯、灯泡、插座等)、获取设备列表或查看设备状态时使用此技能。
- ---
- # 米家设备管理器
- ## 概述
- 此技能用于管理和控制小米/米家智能家居设备,直接调用 [mijiaAPI](https://github.com/Do1e/mijia-api) CLI 通过小米云端 API 控制设备。
- ## 功能特性
- - 登录小米账号(扫码登录)
- - 获取设备列表和家庭列表
- - 获取和设置设备属性
- - 执行设备动作
- - 查看设备完整状态
- ## 前提条件
- 1. 安装依赖:
- ```bash
- pip install mijiaAPI
- ```
- 2. 登录小米账号(首次使用需要):
- ```bash
- python -m mijiaAPI --list_homes
- ```
- ## 快速开始
- ### 1. 首次登录
- ```bash
- python -m mijiaAPI --list_homes
- ```
- 运行后会显示二维码,使用米家 APP 扫描即可完成登录。
- ### 2. 查看设备列表
- ```bash
- python -m mijiaAPI -l
- ```
- 输出中每条设备信息包含 `did`,后续控制命令使用该值。
- ### 3. 控制设备
- ```bash
- # 开灯
- python -m mijiaAPI set --did "123456789" --prop_name "on" --value True
- # 设置亮度
- python -m mijiaAPI set --did "123456789" --prop_name "brightness" --value 50
- # 获取状态
- python -m mijiaAPI get --did "123456789" --prop_name "brightness"
- ```
- ## 命令参考
- ```bash
- python -m mijiaAPI --help
- python -m mijiaAPI get --help
- python -m mijiaAPI set --help
- ```
- **常用命令示例:**
- ```bash
- # 列出所有设备
- python -m mijiaAPI -l
- # 从列表中找到 did
- python -m mijiaAPI -l | grep did
- # 列出所有家庭
- python -m mijiaAPI --list_homes
- # 获取设备属性
- python -m mijiaAPI get --did "123456789" --prop_name "brightness"
- # 设置设备属性
- python -m mijiaAPI set --did "123456789" --prop_name "on" --value True
- python -m mijiaAPI set --did "123456789" --prop_name "brightness" --value 50
- # 执行场景
- python -m mijiaAPI --run_scene "回家"
- ```
- ## 设备属性参考
- 常见设备属性名称:
- | 属性名 | 说明 | 类型 | 示例值 |
- |--------|------|------|--------|
- | `on` | 开关状态 | bool | `True`/`False` |
- | `brightness` | 亮度 | int | 0-100 |
- | `color-temperature` | 色温 | int | 2700-6500 |
- | `color` | 颜色 | int | RGB值 |
- **注意:** 不同设备支持的属性不同,操作前先使用 `--get_device_info DEVICE_MODEL` 获取设备属性信息,确认可操作的属性后再执行控制命令。`DEVICE_MODEL` 可通过 `--list_devices` 获取。
- **操作步骤:**
- 1. 使用 `python -m mijiaAPI -l` 列出设备,确认 `did` 与 `DEVICE_MODEL`。
- 2. 使用 `python -m mijiaAPI --get_device_info DEVICE_MODEL` 获取可用属性与范围。
- 3. 根据属性信息执行 `get` 或 `set` 命令完成查询或控制。
- ## 故障排除
- ### 登录问题
- **问题:无法登录或提示认证失败**
- 1. 删除认证文件重新登录:
- ```bash
- rm ~/.config/mijia-api/auth.json
- python -m mijiaAPI --list_homes
- ```
- 2. 检查网络连接是否正常
- 3. 确认米家APP账号和密码正确
- ### 设备控制问题
- **问题:找不到设备**
- 1. 确认设备已在米家APP中添加
- 2. 检查设备名称是否正确(区分大小写)
- 3. 使用 `-l` 命令查看准确的设备名称
- **问题:不知道 did**
- 1. 使用 `python -m mijiaAPI -l` 列出设备,在输出中找到设备的 `did` 字段
- **问题:属性设置失败**
- 1. 确认设备支持该属性(使用 `--get_device_info DEVICE_MODEL` 获取属性信息)
- 2. 检查属性值范围是否正确
- 3. 确认设备在线且网络正常
- **问题:想知道某个设备都有哪些属性**
- 1. 先用 `--list_devices` 获取 `DEVICE_MODEL`,再用 `--get_device_info DEVICE_MODEL` 获取属性信息,例如:
- ```bash
- python -m mijiaAPI --get_device_info yeelink.light.lamp27
- ```
- ### 获取帮助
- - mijiaAPI GitHub: https://github.com/Do1e/mijia-api
- - 米家规格平台: https://home.miot-spec.com/
README.md · README · 61 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 米家设备管理 SKILL
- 管理和控制小米/米家智能家居设备的 Skill,兼容 openclaw 或 Claude Code 等智能体环境,支持设备发现、开关控制、亮度调节、颜色设置等功能。
- ## 功能特性
- - 扫码登录小米账号
- - 获取设备列表与家庭列表
- - 获取与设置设备属性
- - 执行设备动作与场景
- - 查看设备完整状态
- ## 目录结构
- ```
- .
- ├── SKILL.md
- └── README.md
- ```
- ## 如何安装这个技能
- 将本仓库放入技能目录即可使用:
- ```bash
- git clone https://github.com/dean2021/mijia-device-manager ~/.openclaw/skills/mijia-device-manager
- ```
- 如果是手动下载压缩包,解压后将目录移动到:
- ```
- ~/.openclaw/skills/mijia-device-manager
- ```
- ## 在 openclaw 中触发使用
- 在 openclaw 对话中,直接用自然语言描述你要控制的米家设备。只要需求包含“控制设备”“查询设备列表/状态”“调节亮度/颜色/色温”等意图,就会触发该技能。
- **推荐触发方式**
- - 在需求中显式提到“使用米家设备管理器技能”
- - 描述明确的设备与动作,例如“打开”“关闭”“调到 50% 亮度”
- **示例**
- - 请使用米家设备管理器技能,列出我所有的米家设备
- - 把客厅台灯打开,亮度调到 50%
- - 查询卧室灯当前亮度
- - 把书房灯色温调到 4000K
- ## 你可以让它做什么
- - 列出设备与家庭列表
- - 查询设备当前状态
- - 设置开关、亮度、颜色、色温等属性
- - 执行设备动作与场景
- ## 注意
- - 不同设备支持的属性不同,若某个指令失败,改用“查询该设备支持的属性后再设置”
- - 首次使用时需要完成账号绑定与授权
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.