词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
Home Assistant
Home Assistant 集成
1.
2.
配置
1. 创建长期访 问令牌
1.
2.
3.
4.
5.
2. 配置环境变量
信息
HASS_TOKEN 后，homeassistant 工具集将自动启用。Gateway 平台和设备控制工具均通过这一个令牌激活。3. 启动 Gateway
可用工具
ha_list_entities
domain （可选） — 按实体域过滤：light、switch、climate、sensor、binary_sensor、cover、fan、media_player 等。area （可选） — 按区域/房间名称过滤（与友好名称匹配）：living room、kitchen、bedroom 等。List all lights in the living roomha_get_state
entity_id （必填） — 要查询的实体，例如 light.living_room、climate.thermostat、sensor.temperatureWhat's the current state of climate.thermostat?ha_list_services
domain （可选） — 按域过滤，例如 light、climate、switchWhat services are available for climate devices?ha_call_service
domain （必填） — 服务域：light、switch、climate、cover、media_player、fan、scene、scriptservice （必填） — 服务名称：turn_on、turn_off、toggle、set_temperature、set_hvac_mode、open_cover、close_cover、set_volume_levelentity_id （可选） — 目标实体，例如 light.living_roomdata （可选） — 以 JSON 对象形式传入的附加参数Turn on the living room lights
→ ha_call_service(domain="light", service="turn_on", entity_id="light.living_room")Set the thermostat to 22 degrees in heat mode
→ ha_call_service(domain="climate", service="set_temperature",
entity_id="climate.thermostat", data={"temperature": 22, "hvac_mode": "heat"})Set living room lights to blue at 50% brightness
→ ha_call_service(domain="light", service="turn_on",
entity_id="light.living_room", data={"brightness": 128, "color_name": "blue"})Gateway 平台：实时事件
state_changed 事件。当设备状态发生变更且符合过滤条件时，该事件将作为消息转发给 agent。事件过滤
必要配置
watch_domains、watch_entities 或 watch_all 中的至少一项才能接收事件。若未设置过滤器，启动时将记录警告日志，所有状态变更将被静默丢弃。~/.hermes/config.yaml 中，于 Home Assistant 平台的 extra 部分配置 agent 接收的事件：| 设置 | 默认值 | 说明 |
|---|---|---|
watch_domains | （无） | 仅监听这些实体域（例如 climate、light、binary_sensor） |
watch_entities | （无） | 仅监听这些特定实体 ID |
watch_all | false | 设为 true 以接收所有状态变更（不推荐用于大多数场景） |
ignore_entities | （无） | 始终忽略这些实体（在域/实体过滤器之前应用） |
cooldown_seconds | 30 | 同一实体两次事件之间的最小间隔秒数 |
提示
climate、binary_sensor 和 alarm_control_panel 已覆盖最常用的自动化场景。按需添加更多域。使用 ignore_entities 屏蔽 CPU 温度或运行时间计数器等噪声传感器。事件格式化
| 域 | 格式 |
|---|---|
climate | "HVAC mode changed from 'off' to 'heat' (current: 21, target: 23)" |
sensor | "changed from 21°C to 22°C" |
binary_sensor | "triggered" / "cleared" |
light、switch、fan | "turned on" / "turned off" |
alarm_control_panel | "alarm state changed from 'armed_away' to 'triggered'" |
| （其他） | "changed from 'old' to 'new'" |
Agent 响应
persistent_notification.create），标题为"Hermes Agent"，显示在 HA 通知面板中。连接管理
HASS_TOKEN 负责验证连接）安全性
已屏蔽的域
shell_command — 任意 shell 命令command_line — 执行命令的传感器/开关python_script — 脚本化 Python 执行pyscript — 更广泛的脚本集成hassio — 插件控制、主机关机/重启rest_command — 来自 HA 服务器的 HTTP 请求（SSRF 向量）^[a-z_][a-z0-9_]*\.[a-z0-9_]+$ 进行验证，以防止注入攻击。自动化示例
晨间例程
User: Start my morning routine
Agent:
1. ha_call_service(domain="light", service="turn_on",
entity_id="light.bedroom", data={"brightness": 128})
2. ha_call_service(domain="climate", service="set_temperature",
entity_id="climate.thermostat", data={"temperature": 22})
3. ha_call_service(domain="media_player", service="turn_on",
entity_id="media_player.kitchen_speaker")安全检查
User: Is the house secure?
Agent:
1. ha_list_entities(domain="binary_sensor")
→ checks door/window sensors
2. ha_get_state(entity_id="alarm_control_panel.home")
→ checks alarm status
3. ha_list_entities(domain="lock")
→ checks lock states
4. Reports: "All doors closed, alarm is armed_away, all locks engaged."响应式自动化（通过 Gateway 事件）
[Home Assistant] Front Door: triggered (was cleared)
Agent automatically:
1. ha_get_state(entity_id="binary_sensor.front_door")
2. ha_call_service(domain="light", service="turn_on",
entity_id="light.hallway")
3. Sends notification: "Front door opened. Hallway lights turned on."修改于 2026-05-31 00:25:01