b87702bef0
- Documented changes in changelog for version 0.1.3. - Improved error handling in async_check_connection to propagate OpenClawApiError. - Added clear error messages for users regarding OpenAI API settings in config flow. - Updated translations to include new error messages related to OpenAI API status.
63 lines
2.9 KiB
Markdown
63 lines
2.9 KiB
Markdown
# Changelog
|
|
|
|
All notable changes to the OpenClaw Home Assistant Integration will be documented in this file.
|
|
|
|
## [0.1.3] - 2026-02-20
|
|
|
|
### Fixed
|
|
- `async_check_connection()` no longer silently swallows `OpenClawApiError`.
|
|
Previously any API-level error (e.g. gateway returning HTML) was caught and
|
|
converted to a generic "Cannot connect" message with no indication of the
|
|
real cause. The error is now propagated to the config flow.
|
|
- Config flow now catches `OpenClawApiError` separately and shows a clear,
|
|
actionable error message: **"openai_api_disabled"** — pointing the user to
|
|
enable `enable_openai_api` in the addon settings and restart.
|
|
- Auto-discovery now logs a `WARNING` when `enable_openai_api` is `false` in
|
|
the addon options, making the issue visible in the HA log before setup fails.
|
|
|
|
### Changed
|
|
- The `enable_openai_api` addon option (default `false`) must be `true` for the
|
|
integration to connect. The `/v1/models` probe endpoint requires the
|
|
OpenAI-compatible API layer to be active.
|
|
|
|
## [0.1.2] - 2026-02-20
|
|
|
|
### Fixed
|
|
- Removed non-existent `/api/status` and `/api/sessions` gateway endpoints that caused
|
|
the integration to receive HTML pages instead of JSON, resulting in `ContentTypeError`
|
|
on every poll and a failed config flow connection check.
|
|
- `async_check_connection()` now probes `/v1/models` (the only reliable GET endpoint on
|
|
the gateway) instead of the missing `/api/status`.
|
|
|
|
### Changed
|
|
- `DataUpdateCoordinator` now performs a single `/v1/models` request per poll cycle
|
|
instead of three separate requests (`/api/status`, `/api/sessions`, `/v1/models`).
|
|
- `DATA_GATEWAY_VERSION`, `DATA_UPTIME`, `DATA_SESSION_COUNT`, and `DATA_SESSIONS`
|
|
report unavailable values (`None` / `0` / `[]`) since the gateway does not expose
|
|
dedicated status or session endpoints.
|
|
- Removed `_model_poll_counter` (no longer needed with a unified poll).
|
|
|
|
### Added
|
|
- Integration icon and logo (sourced from the OpenClaw Assistant add-on).
|
|
|
|
## [0.1.1] - 2026-02-20
|
|
|
|
### Fixed
|
|
- Added content-type guard in `_request()`: when the gateway returns a non-JSON
|
|
response (e.g. HTML redirect/login page), a clear `OpenClawApiError` is now raised
|
|
instead of an unhandled `aiohttp.ContentTypeError`.
|
|
|
|
## [0.1.0] - 2026-02-20
|
|
|
|
### Added
|
|
- Initial release of the OpenClaw Home Assistant Integration.
|
|
- Config flow with automatic add-on discovery and manual host/port/token entry.
|
|
- `sensor` platform: Status, Last Activity, Session Count, Active Model.
|
|
- `binary_sensor` platform: Gateway Connected.
|
|
- `conversation` platform: native HA Assist / Voice PE agent backed by the
|
|
OpenClaw gateway `/v1/chat/completions` endpoint (SSE streaming supported).
|
|
- `DataUpdateCoordinator` polling the gateway on a configurable interval (default 30 s).
|
|
- Service calls: `openclaw.send_message`, `openclaw.clear_history`.
|
|
- Lovelace `openclaw-chat-card` custom card (`www/openclaw-chat-card.js`).
|
|
- HACS-compatible repository structure (`hacs.json`).
|