← Back to Skills Marketplace
小米智能家居 (Xiao Mi Home for HA)
by
DillonHuang
· GitHub ↗
· v1.0.0
· MIT-0
292
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install xiaomi-homne-ha
Description
Control Xiaomi/Mi Home devices via Home Assistant REST API for lights, switches, sensors, AC, fans, media players, and scenes using natural language.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install xiaomi-homne-ha - After installation, invoke the skill by name or use
/xiaomi-homne-ha - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 小米智能家居 (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. It is an AI Agent Skill for Claude Code / OpenClaw, with 292 downloads so far.
How do I install 小米智能家居 (Xiao Mi Home for HA)?
Run "/install xiaomi-homne-ha" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 小米智能家居 (Xiao Mi Home for HA) free?
Yes, 小米智能家居 (Xiao Mi Home for HA) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 小米智能家居 (Xiao Mi Home for HA) support?
小米智能家居 (Xiao Mi Home for HA) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 小米智能家居 (Xiao Mi Home for HA)?
It is built and maintained by DillonHuang (@huangqiulong); the current version is v1.0.0.
More Skills