← 返回 Skills 市场
小米智能家居 (Xiao Mi Home for HA)
作者
DillonHuang
· GitHub ↗
· v1.0.0
· MIT-0
292
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install xiaomi-homne-ha
功能描述
Control Xiaomi/Mi Home devices via Home Assistant REST API for lights, switches, sensors, AC, fans, media players, and scenes using natural language.
安全使用建议
Functionally this skill looks coherent for controlling Home Assistant. Before installing: 1) Confirm the registry metadata discrepancy (the published metadata did not list HA_URL/HA_TOKEN while SKILL.md does). 2) Only provide a long‑lived HA token you trust the agent with; avoid pasting it into public or shared chats. 3) Consider creating a Home Assistant token with limited privileges if possible and test the skill using the provided mock server (test-mock.sh) before pointing it at your real HA instance. 4) Review the openclaw config write step — the skill will persist the token in ~/.openclaw/openclaw.json via openclaw config set, so ensure your OpenClaw config storage is secure.
功能分析
Type: OpenClaw Skill
Name: xiaomi-homne-ha
Version: 1.0.0
The skill bundle is a well-structured tool for controlling Home Assistant devices via its REST API. It includes a mock server (mock-ha-server.py) and comprehensive test suites (test.sh, test-mock.sh) to verify functionality. The instructions in SKILL.md are transparent, bilingual, and strictly aligned with the stated purpose of device management, with no evidence of malicious intent, data exfiltration, or prompt injection.
能力评估
Purpose & Capability
Name/description (control Xiaomi devices through Home Assistant REST API) align with the declared requirements in SKILL.md (curl, jq, HA_URL, HA_TOKEN). The bundled scripts (test.sh, test-mock.sh, mock-ha-server.py) are test/mock utilities useful for offline and live testing and are consistent with the skill's purpose. Note: registry metadata at the top of the submission shows no required env vars/binaries whereas SKILL.md does declare them — this is an inconsistency in the published metadata but not a functional mismatch.
Instruction Scope
SKILL.md only instructs using the Home Assistant REST API (GET /api/states, POST /api/services/...) via curl/jq. It also instructs storing HA_URL/HA_TOKEN in OpenClaw config (openclaw config set) or editing ~/.openclaw/openclaw.json; these actions are within scope for a skill that needs persistent credentials. Caution: the doc suggests pasting long-lived tokens in chat for the AI to run openclaw config set — that is a user-privacy risk (not a technical incoherence).
Install Mechanism
No install spec (instruction-only runtime) — lowest install risk. The repository includes test scripts and a simple local mock server (Python stdlib) that are harmless local test tooling. No downloads from external/unknown URLs or extracted archives are present.
Credentials
The only runtime secrets the skill needs are HA_URL and a long-lived HA_TOKEN, which are proportional to controlling a Home Assistant instance. There are no unrelated credentials requested. Note the registry metadata did not list these env vars but SKILL.md does — you should confirm the platform will prompt for/provide these before enabling the skill.
Persistence & Privilege
always:false (normal). The skill's workflow expects to write its own config entries (openclaw config set or editing ~/.openclaw/openclaw.json) so it can persist the HA_TOKEN; this is expected for a skill that must contact your HA instance. It does not request system-wide privileges or modify other skills.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install xiaomi-homne-ha - 安装完成后，直接呼叫该 Skill 的名称或使用
/xiaomi-homne-ha触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
xiaomi-home-ha v1.0.0
- Initial release.
- Enables natural-language control of Xiaomi/Mi Home devices via Home Assistant REST API.
- Supports querying device states and controlling lights, switches, sensors, AC, fans, media players, and scenes.
- Detailed configuration instructions in both Chinese and English.
- Requires curl and jq; configuration via environment variables.
- Includes example API usage and command templates for flexible smart home control.
元数据
常见问题
小米智能家居 (Xiao Mi Home for HA) 是什么？
Control Xiaomi/Mi Home devices via Home Assistant REST API for lights, switches, sensors, AC, fans, media players, and scenes using natural language. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 292 次。
如何安装 小米智能家居 (Xiao Mi Home for HA)？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install xiaomi-homne-ha」即可一键安装，无需额外配置。
小米智能家居 (Xiao Mi Home for HA) 是免费的吗？
是的，小米智能家居 (Xiao Mi Home for HA) 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
小米智能家居 (Xiao Mi Home for HA) 支持哪些平台？
小米智能家居 (Xiao Mi Home for HA) 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 小米智能家居 (Xiao Mi Home for HA)？
由 DillonHuang（@huangqiulong）开发并维护，当前版本 v1.0.0。
推荐 Skills