Files
2026-05-06 08:08:18 +02:00

111 lines
3.9 KiB
Python

"""Select entity for the OpenClaw integration.
Provides a Select entity that exposes the list of available models
from the gateway's /v1/models endpoint, allowing the user to switch
the active model from the HA dashboard.
"""
from __future__ import annotations
import logging
from typing import Any
from homeassistant.components.select import SelectEntity, SelectEntityDescription
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.update_coordinator import CoordinatorEntity
from .const import DATA_MODEL, DOMAIN
from .coordinator import OpenClawCoordinator
_LOGGER = logging.getLogger(__name__)
SELECT_DESCRIPTIONS: tuple[SelectEntityDescription, ...] = (
SelectEntityDescription(
key="active_model",
translation_key="active_model",
name="OpenClaw Active Model",
icon="mdi:brain",
),
)
async def async_setup_entry(
hass: HomeAssistant,
entry: ConfigEntry,
async_add_entities: AddEntitiesCallback,
) -> None:
"""Set up OpenClaw select entities from a config entry."""
entry_data: dict = hass.data[DOMAIN][entry.entry_id]
coordinator: OpenClawCoordinator = entry_data["coordinator"]
entities = [
OpenClawModelSelect(coordinator, description, entry)
for description in SELECT_DESCRIPTIONS
]
async_add_entities(entities)
class OpenClawModelSelect(CoordinatorEntity[OpenClawCoordinator], SelectEntity):
"""Select entity for switching the active OpenClaw model."""
_attr_has_entity_name = True
def __init__(
self,
coordinator: OpenClawCoordinator,
description: SelectEntityDescription,
entry: ConfigEntry,
) -> None:
"""Initialize the select entity."""
super().__init__(coordinator)
self.entity_description = description
self._entry = entry
self._attr_unique_id = f"{entry.entry_id}_{description.key}"
self._attr_device_info = {
"identifiers": {(DOMAIN, entry.entry_id)},
"name": "OpenClaw Assistant",
"manufacturer": "OpenClaw",
"model": "OpenClaw Gateway",
}
# Initialise from coordinator cache
models = coordinator.available_models
self._attr_options = models if models else ["unknown"]
selected = entry.options.get(description.key)
current = selected or (coordinator.data or {}).get(DATA_MODEL)
self._attr_current_option = current if current in self._attr_options else (
self._attr_options[0] if self._attr_options else None
)
@callback
def _handle_coordinator_update(self) -> None:
"""Update options and current selection when coordinator refreshes."""
models = self.coordinator.available_models
if models:
self._attr_options = models
selected = self._entry.options.get(self.entity_description.key)
current = selected or (self.coordinator.data or {}).get(DATA_MODEL)
if current and current in self._attr_options:
self._attr_current_option = current
self.async_write_ha_state()
async def async_select_option(self, option: str) -> None:
"""Handle the user selecting a new model.
Persists the selection in the config entry's options so that the
conversation agent and card can read it via ``get_settings``.
Then triggers a coordinator refresh.
"""
_LOGGER.info("OpenClaw active model changed to: %s", option)
self._attr_current_option = option
# Store in config entry options so other components can read it
new_options = dict(self._entry.options)
new_options["active_model"] = option
self.hass.config_entries.async_update_entry(
self._entry, options=new_options
)
self.async_write_ha_state()