Skip to content
Back to search

mijia-device-manager

管理和控制小米/米家智能家居设备的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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dean2021--mijia-device-manager/badge.svg)](/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)

  1. ---
  2. name: mijia-device-manager
  3. description: 管理和控制小米/米家智能家居设备,直接调用 mijiaAPI CLI 命令通过小米云端 API 控制设备。支持设备发现、开关控制、亮度调节、颜色设置等功能。当用户需要控制小米智能设备(如台灯、灯泡、插座等)、获取设备列表或查看设备状态时使用此技能。
  4. ---
  5. # 米家设备管理器
  6. ## 概述
  7. 此技能用于管理和控制小米/米家智能家居设备,直接调用 [mijiaAPI](https://github.com/Do1e/mijia-api) CLI 通过小米云端 API 控制设备。
  8. ## 功能特性
  9. - 登录小米账号(扫码登录)
  10. - 获取设备列表和家庭列表
  11. - 获取和设置设备属性
  12. - 执行设备动作
  13. - 查看设备完整状态
  14. ## 前提条件
  15. 1. 安装依赖:
  16. ```bash
  17. pip install mijiaAPI
  18. ```
  19. 2. 登录小米账号(首次使用需要):
  20. ```bash
  21. python -m mijiaAPI --list_homes
  22. ```
  23. ## 快速开始
  24. ### 1. 首次登录
  25. ```bash
  26. python -m mijiaAPI --list_homes
  27. ```
  28. 运行后会显示二维码,使用米家 APP 扫描即可完成登录。
  29. ### 2. 查看设备列表
  30. ```bash
  31. python -m mijiaAPI -l
  32. ```
  33. 输出中每条设备信息包含 `did`,后续控制命令使用该值。
  34. ### 3. 控制设备
  35. ```bash
  36. # 开灯
  37. python -m mijiaAPI set --did "123456789" --prop_name "on" --value True
  38. # 设置亮度
  39. python -m mijiaAPI set --did "123456789" --prop_name "brightness" --value 50
  40. # 获取状态
  41. python -m mijiaAPI get --did "123456789" --prop_name "brightness"
  42. ```
  43. ## 命令参考
  44. ```bash
  45. python -m mijiaAPI --help
  46. python -m mijiaAPI get --help
  47. python -m mijiaAPI set --help
  48. ```
  49. **常用命令示例:**
  50. ```bash
  51. # 列出所有设备
  52. python -m mijiaAPI -l
  53. # 从列表中找到 did
  54. python -m mijiaAPI -l | grep did
  55. # 列出所有家庭
  56. python -m mijiaAPI --list_homes
  57. # 获取设备属性
  58. python -m mijiaAPI get --did "123456789" --prop_name "brightness"
  59. # 设置设备属性
  60. python -m mijiaAPI set --did "123456789" --prop_name "on" --value True
  61. python -m mijiaAPI set --did "123456789" --prop_name "brightness" --value 50
  62. # 执行场景
  63. python -m mijiaAPI --run_scene "回家"
  64. ```
  65. ## 设备属性参考
  66. 常见设备属性名称:
  67. | 属性名 | 说明 | 类型 | 示例值 |
  68. |--------|------|------|--------|
  69. | `on` | 开关状态 | bool | `True`/`False` |
  70. | `brightness` | 亮度 | int | 0-100 |
  71. | `color-temperature` | 色温 | int | 2700-6500 |
  72. | `color` | 颜色 | int | RGB值 |
  73. **注意:** 不同设备支持的属性不同,操作前先使用 `--get_device_info DEVICE_MODEL` 获取设备属性信息,确认可操作的属性后再执行控制命令。`DEVICE_MODEL` 可通过 `--list_devices` 获取。
  74. **操作步骤:**
  75. 1. 使用 `python -m mijiaAPI -l` 列出设备,确认 `did` 与 `DEVICE_MODEL`。
  76. 2. 使用 `python -m mijiaAPI --get_device_info DEVICE_MODEL` 获取可用属性与范围。
  77. 3. 根据属性信息执行 `get` 或 `set` 命令完成查询或控制。
  78. ## 故障排除
  79. ### 登录问题
  80. **问题:无法登录或提示认证失败**
  81. 1. 删除认证文件重新登录:
  82. ```bash
  83. rm ~/.config/mijia-api/auth.json
  84. python -m mijiaAPI --list_homes
  85. ```
  86. 2. 检查网络连接是否正常
  87. 3. 确认米家APP账号和密码正确
  88. ### 设备控制问题
  89. **问题:找不到设备**
  90. 1. 确认设备已在米家APP中添加
  91. 2. 检查设备名称是否正确(区分大小写)
  92. 3. 使用 `-l` 命令查看准确的设备名称
  93. **问题:不知道 did**
  94. 1. 使用 `python -m mijiaAPI -l` 列出设备,在输出中找到设备的 `did` 字段
  95. **问题:属性设置失败**
  96. 1. 确认设备支持该属性(使用 `--get_device_info DEVICE_MODEL` 获取属性信息)
  97. 2. 检查属性值范围是否正确
  98. 3. 确认设备在线且网络正常
  99. **问题:想知道某个设备都有哪些属性**
  100. 1. 先用 `--list_devices` 获取 `DEVICE_MODEL`,再用 `--get_device_info DEVICE_MODEL` 获取属性信息,例如:
  101. ```bash
  102. python -m mijiaAPI --get_device_info yeelink.light.lamp27
  103. ```
  104. ### 获取帮助
  105. - mijiaAPI GitHub: https://github.com/Do1e/mijia-api
  106. - 米家规格平台: 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)

  1. # 米家设备管理 SKILL
  2. 管理和控制小米/米家智能家居设备的 Skill,兼容 openclaw 或 Claude Code 等智能体环境,支持设备发现、开关控制、亮度调节、颜色设置等功能。
  3. ## 功能特性
  4. - 扫码登录小米账号
  5. - 获取设备列表与家庭列表
  6. - 获取与设置设备属性
  7. - 执行设备动作与场景
  8. - 查看设备完整状态
  9. ## 目录结构
  10. ```
  11. .
  12. ├── SKILL.md
  13. └── README.md
  14. ```
  15. ## 如何安装这个技能
  16. 将本仓库放入技能目录即可使用:
  17. ```bash
  18. git clone https://github.com/dean2021/mijia-device-manager ~/.openclaw/skills/mijia-device-manager
  19. ```
  20. 如果是手动下载压缩包,解压后将目录移动到:
  21. ```
  22. ~/.openclaw/skills/mijia-device-manager
  23. ```
  24. ## 在 openclaw 中触发使用
  25. 在 openclaw 对话中,直接用自然语言描述你要控制的米家设备。只要需求包含“控制设备”“查询设备列表/状态”“调节亮度/颜色/色温”等意图,就会触发该技能。
  26. **推荐触发方式**
  27. - 在需求中显式提到“使用米家设备管理器技能”
  28. - 描述明确的设备与动作,例如“打开”“关闭”“调到 50% 亮度”
  29. **示例**
  30. - 请使用米家设备管理器技能,列出我所有的米家设备
  31. - 把客厅台灯打开,亮度调到 50%
  32. - 查询卧室灯当前亮度
  33. - 把书房灯色温调到 4000K
  34. ## 你可以让它做什么
  35. - 列出设备与家庭列表
  36. - 查询设备当前状态
  37. - 设置开关、亮度、颜色、色温等属性
  38. - 执行设备动作与场景
  39. ## 注意
  40. - 不同设备支持的属性不同,若某个指令失败,改用“查询该设备支持的属性后再设置”
  41. - 首次使用时需要完成账号绑定与授权

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.