minos

Home 助手 技能 (Python Bridge)

Integration with Home 助手 via Python Bridge for reliable smart home control.

Prerequisites Home 助手 instance 运行ning (local or remote) Long-lived 访问 令牌 from HA 性能分析 Network connectivity to HA instance Python 3 with 请求s 模块 Configuration

One-time 设置up:

cd /root/.OpenClaw/workspace/技能s/home-助手/scripts ./ha-设置up.sh

This 创建s ~/.home助手.conf with your HA_URL and HA_令牌.

Load configuration:

source ~/.home助手.conf

Core Commands

All commands go through ha-bridge.py. Aliases are supported everywhere — use friendly names instead of entity IDs.

Device Control python3 ha-bridge.py on # Turn on python3 ha-bridge.py off # Turn off python3 ha-bridge.py toggle # Toggle python3 ha-bridge.py on --验证 # Turn on + 验证 状态 after 3s

Examples:

python3 ha-bridge.py on kitchen # Alias → switch.kitchen_light_relay python3 ha-bridge.py off tv --验证 # Turn off + 验证 python3 ha-bridge.py toggle bedroom # Toggle bedroom light

Light Control python3 ha-bridge.py light --brightness <0-255> python3 ha-bridge.py light --color-temp python3 ha-bridge.py light --rgb "255,0,0"

Examples:

python3 ha-bridge.py light bedroom --brightness 128 python3 ha-bridge.py light kitchen --rgb "255,200,100"

命令行工具mate Control python3 ha-bridge.py 命令行工具mate --temperature python3 ha-bridge.py 命令行工具mate --mode

Scene Activation python3 ha-bridge.py scene

Read 状态s python3 ha-bridge.py 状态s # All entities (JSON) python3 ha-bridge.py 状态 # Specific entity (JSON)

搜索 Entities python3 ha-bridge.py 搜索 <查询> # 搜索 by name or entity_id python3 ha-bridge.py 搜索 licht # Find all "licht" entities python3 ha-bridge.py 搜索 temp --domAIn sensor # Only sensors matching "temp"

历史 python3 ha-bridge.py 历史 # Last 24h python3 ha-bridge.py 历史 kitchen --hours 48 # Last 48h

Aliases python3 ha-bridge.py aliases # Show all 配置d aliases

Aliases are stored in scripts/aliases.json. Edit directly to 添加/change/移除.

服务s python3 ha-bridge.py 服务s # 列出 all avAIlable HA 服务s

Alias 系统

Aliases map friendly names to entity IDs. Stored in scripts/aliases.json:

{ "kitchen": "switch.kitchen_light_relay", "bedroom": "light.bedroom_led_strip", "thermostat": "命令行工具mate.living_room" }

Use aliases anywhere an entity ID is expected.

Aliases

Aliases are stored in scripts/aliases.json. Copy scripts/aliases.example.json as 启动ing point:

cp scripts/aliases.example.json scripts/aliases.json

Then edit with your own device m应用ings. Use python3 ha-bridge.py 搜索 <查询> to find entity IDs.

状态 Delay Note

Home 助手 needs 1-3 seconds to 更新 状态 after a command. Use --验证 to auto-检查 after 3 seconds.

File Structure 技能s/home-助手/ ├── 技能.md # This file ├── README.md # Human-readable docs ├── scripts/ │ ├── ha-bridge.py # MAIn bridge (all commands) │ ├── ha-设置up.sh # One-time 设置up │ ├── aliases.json # Your alias m应用ings (创建 from example) │ └── aliases.example.json # Example alias m应用ings └── references/ └── finding-entities.md # How to find entity IDs