Home Assistant Agent Interface v0.4.3

Highlights

• Adds a prominent recent-release changelog to the marketplace README.
• Links directly to the complete GitHub changelog and release archive.
• Includes CHANGELOG.md in every published package for offline inspection.

Validation

• 54 automated tests
• Clean plugin, privacy, ClawHub, and dependency audits
• Green stable and beta gateway compatibility jobs
• Exact package inspection confirms both README.md and CHANGELOG.md are present

Install

openclaw plugins install clawhub:homeassistant-agent-interface@0.4.3

Home Assistant Agent Interface v0.4.2

Fixed

• Accept canonical OpenClaw SecretRef objects for the Home Assistant token on stable and beta hosts.
• Preserve SecretRefs in openclaw.json while allowing OpenClaw to materialize them before plugin registration.
• Add host-level regression coverage that configures the reference through the CLI and invokes home_assistant_diagnose through a real isolated gateway.

Compatibility

• OpenClaw stable 2026.7.1-2 or newer: complete six-tool interface and bundled skill.
• OpenClaw beta 2026.8.1-beta.3 or newer: the same interface plus host-visible output schemas and the new store SecretRef source.

Validation

• 54 automated tests
• Clean plugin, privacy, ClawHub, and dependency audits
• Green stable and beta CI compatibility jobs
• Exact v0.4.2 artifact tested with stored-reference and runtime-materialization assertions

Install

openclaw plugins install clawhub:homeassistant-agent-interface@0.4.2

Home Assistant Agent Interface v0.4.1

Fixed

• Fresh installation on OpenClaw stable now completes before Home Assistant settings are supplied.
• openclaw config set can configure the newly installed plugin normally.
• The plugin remains inactive until baseUrl and token are configured, and tool execution preserves the explicit CONFIG_REQUIRED result when either is missing.

Compatibility

• OpenClaw stable 2026.7.1-2 or newer: complete six-tool interface and bundled skill.
• OpenClaw beta 2026.8.1-beta.2 or newer: the same interface plus host-visible output schemas.

Validation

• 40 automated tests
• Clean plugin, privacy, and dependency audits
• Stable and beta CI compatibility jobs
• Exact v0.4.1 artifact installed from an empty stable profile and an isolated beta profile

Install

openclaw plugins install clawhub:homeassistant-agent-interface@0.4.1 --acknowledge-clawhub-risk

Home Assistant Agent Interface v0.4.0

Highlights

• Official support for the current OpenClaw stable channel, starting with 2026.7.1-2.
• The complete six-tool interface and bundled operating skill work on both stable and beta hosts.
• OpenClaw 2026.8.1-beta.2 and newer additionally receive host-visible output-schema declarations.
• A stable/beta compatibility matrix now gates every release.

Validation

• 37 automated tests
• Plugin metadata and privacy validation
• Stable and beta host compatibility jobs
• Clean production dependency audit
• Exact release artifact installed and inspected on both host versions

Install

openclaw plugins install clawhub:homeassistant-agent-interface@0.4.0 --acknowledge-clawhub-risk

See the README for configuration and examples.

Home Assistant Agent Interface v0.3.1

Highlights

• Leads with the core differentiator: six compact tools replace raw Home Assistant state dumps and repeated API calls.
• Adds a concise “What you can ask” section with practical lighting, presence, and diagnostics examples.
• Publishes to ClawHub under the more discoverable Tools category.

Compatibility

No runtime behavior changed. The plugin continues to support OpenClaw 2026.8.1-beta.2 and newer.

Validation

• 36 tests passed.
• OpenClaw plugin validation passed.
• ClawHub Plugin Inspector passed with zero findings.
• Dependency audit found zero vulnerabilities.
• The exact release tarball loaded all six tools and the bundled home-assistant-interface skill in an isolated OpenClaw 2026.8.1-beta.2 profile.

Install

openclaw plugins install clawhub:homeassistant-agent-interface

Home Assistant Agent Interface v0.3.0

Highlights

• Ships the home-assistant-interface operating skill with the native plugin.
• Guides agents toward compact discovery, direct action execution, progressive inspection, and precise interpretation of asynchronous observations.
• Keeps household identities, action catalogs, approvals, and authorization policy out of the plugin and skill.

Packaging and documentation

• Includes the skill in the OpenClaw manifest and ClawPack artifact.
• Makes ClawHub the primary reviewed installation route.
• Publishes exact OpenClaw and Node.js compatibility requirements.
• Uses the tested npm tarball for ClawHub publication provenance.

Validation

• 36 tests passed.
• OpenClaw plugin validation passed.
• ClawHub inspector and security scans passed with zero findings.
• Public ClawHub installation loaded all six tools and the bundled skill.
• npm audit reported zero vulnerabilities.

Distribution

Published on ClawHub: https://clawhub.ai/plugins/homeassistant-agent-interface

Install with: openclaw plugins install clawhub:homeassistant-agent-interface

Upgrade notes

No configuration or tool API changes are required from v0.2.1.

Home Assistant Agent Interface v0.2.1

v0.2.1 improves action feedback for physical devices whose state reaches Home Assistant asynchronously.

Fixes and improvements:

• Read target state immediately after an accepted action, then poll only while no change is visible
• Exit early as soon as any observed target changes
• Distinguish changed from no_change_observed without changing the existing observation status contract
• Report observation attempts, configured settle deadline, and actual wait time
• Configure defaults with observationSettleMs and observationPollMs
• Override individual calls with settle_ms and poll_interval_ms; use settle_ms 0 for one immediate read
• Propagate cancellation during an active settle window

Defaults:

• Settle deadline: 1500 ms
• Poll interval: 250 ms

Validation:

• 35 tests passed
• OpenClaw plugin validation passed
• ClawHub inspector passed with zero findings
• npm audit reported zero vulnerabilities

ClawHub publication remains separate from this GitHub release.

Home Assistant Agent Interface v0.2.0

v0.2 turns the plugin into a complete read-and-control interface for Home Assistant agents.

Highlights:

• Live search across entities, actions, areas, devices, floors, and labels
• General Home Assistant action execution using native entity, device, area, floor, and label targets
• Compact before/after observations, missing-target reporting, context IDs, and optional action responses
• Exact on-demand attribute inspection and progressive action-field guidance
• WebSocket batching with stable errors, timeouts, cancellation, and byte caps
• 32 tests covering action calls, partial catalogs, ambiguity, malformed data, aborts, oversized responses, and base paths

Configuration change:

• allowedEntities and allowedDomains were removed. Home Assistant token permissions are the authority boundary; the plugin does not maintain a second policy layer.

Validated against OpenClaw 2026.8.1-beta.2. ClawHub publication is intentionally separate from this GitHub release.