← 返回 Skills 市场
304
总下载
0
收藏
0
当前安装
11
版本数
在 OpenClaw 中安装
/install py-homeassistant-cli
功能描述
Tiny and short Python CLI tool to control Home Assistant devices and automations via the REST API. No external dependencies — uses only Python 3.6+ standard...
安全使用建议
This skill is coherent for controlling Home Assistant and includes its source code so you can review it. Note the registry metadata omitted required env vars — you will need to provide HA_URL and a long‑lived HA_TOKEN (sensitive). Before installing: (1) create a dedicated long‑lived token with minimal scope for this CLI, (2) ensure HA_URL points to your trusted Home Assistant instance (prefer a private network address or HTTPS endpoint), (3) verify the confirmation prompts for sensitive actions are respected in your agent workflow, and (4) review the bundled script if you have any policy that forbids network calls from skills. If you want stricter limits, do not give this skill a token that can control locks, alarms, or garage doors.
功能分析
Type: OpenClaw Skill
Name: py-homeassistant-cli
Version: 1.0.10
The skill is a functional Python CLI tool designed to control Home Assistant via its REST API using only standard libraries. It includes safety instructions in SKILL.md that explicitly tell the AI agent to seek user confirmation for sensitive actions like operating locks or security systems. While the tool provides powerful capabilities such as arbitrary service calls and Jinja2 template evaluation via the Home Assistant API, these are consistent with its stated purpose, and there is no evidence of data exfiltration, obfuscation, or malicious intent.
能力评估
Purpose & Capability
Name, description, SKILL.md, README, and the included script all align: this is a Home Assistant CLI that talks to a user-provided Home Assistant REST API. The only mismatch is registry-level metadata that reported 'Required env vars: none' while the SKILL.md and the script clearly use HA_URL and HA_TOKEN.
Instruction Scope
Runtime instructions and the script confine actions to the Home Assistant REST API (server provided by HA_URL/--server). The SKILL.md explicitly asks for user confirmation before sensitive actions (locks, alarms, garage doors). The instructions do not ask to read unrelated files or contact external endpoints outside the configured HA server.
Install Mechanism
There is no install spec and no network downloads; the skill is instruction-only plus a bundled Python script. No external packages or arbitrary URLs are fetched during install.
Credentials
The script legitimately needs HA_URL and HA_TOKEN (long‑lived access token) — these are proportionate to its functionality. However, the registry metadata omitted those required env vars, which is an inconsistency users should be aware of. HA_TOKEN is sensitive: provide a token with minimal privileges and avoid sharing broadly.
Persistence & Privilege
The skill does not request always:true or any elevated persistence. It runs locally and only performs network calls to the configured HA server. Autonomous invocation is allowed (platform default) but is not combined with other concerning privileges.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install py-homeassistant-cli - 安装完成后，直接呼叫该 Skill 的名称或使用
/py-homeassistant-cli触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.10
- Fixed typo in environment variable name: replaced "HASS_TOKEN" with "HA_TOKEN" in `metadata`.
- No changes to code or features; documentation metadata only.
v1.0.9
- Added optional environment variable setup instructions for `HA_URL` and `HA_TOKEN`.
- Updated references from `HASS_SERVER`/`HASS_TOKEN` to `HA_URL`/`HA_TOKEN` in metadata and documentation.
- Clarified environment variable usage and ordering relative to command-line arguments.
v1.0.8
- Added environment variable documentation (HASS_SERVER, HASS_TOKEN) to metadata for clearer configuration.
- No changes to tool commands or CLI behavior.
- Documentation in SKILL.md updated for improved clarity on environment variable setup.
v1.0.7
- Metadata updated: renamed skill to "py-homeassistant-cli", and version number removed from metadata.
- Description refined to "Tiny and short Python CLI tool".
- No code or functional changes in this version.
- Documentation remains unchanged except for minor metadata and description updates.
v1.0.6
- Removed setup instructions using environment variables; now the only documented method is passing credentials via command-line arguments.
- No other content or command changes detected.
v1.0.5
- Removed unused "env" value from the metadata "requires" section in SKILL.md.
- No user-facing functionality changes.
v1.0.4
- Minor metadata update: removed the unused "primaryEnv" field from the metadata section.
- No changes to functionality, commands, or documentation content.
v1.0.3
- Updated skill description to clarify the tool is a Python CLI with no external dependencies.
- No code or functionality changes in this version.
v1.0.2
- Updated the GitHub homepage URL in the skill metadata from `https://github.com/xwings/homeassistant-cli` to `https://github.com/xwings/py-homeassistant-cli`.
- No other changes detected.
v1.0.1
- Updated the metadata author field from "anotb" to "xwings".
- Changed the metadata "bins" field to explicitly include the Python CLI path: "python3 {baseDir}/scripts/homeassistant-cli.py".
- No functional or command changes made to the skill.
v1.0.0
Major update: Switches from using the official hass-cli and extensive markdown documentation to a new, self-contained Python CLI with simplified, wide-ranging functionality.
- Replaces the previous hass-cli-based implementation with a custom Python CLI tool for direct Home Assistant REST API control.
- No external dependencies; only the Python standard library is required.
- Significantly expanded command set covering 25 domains (lights, climate, locks, presence, weather, calendar, script, and more).
- Documentation focuses on concise usage, entity and service discovery, advanced control, and safety rules for sensitive actions.
- Old reference/example/troubleshooting files removed; usage and setup are now fully documented within a single markdown.
- New MIT license and updated project metadata.
元数据
常见问题
py-homeassistant-cli 是什么？
Tiny and short Python CLI tool to control Home Assistant devices and automations via the REST API. No external dependencies — uses only Python 3.6+ standard... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 304 次。
如何安装 py-homeassistant-cli？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install py-homeassistant-cli」即可一键安装，无需额外配置。
py-homeassistant-cli 是免费的吗？
是的，py-homeassistant-cli 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
py-homeassistant-cli 支持哪些平台？
py-homeassistant-cli 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 py-homeassistant-cli？
由 xwings（@xwings）开发并维护，当前版本 v1.0.10。
推荐 Skills