# Home Assistant

> Control smart home devices via Home Assistant. Lights, climate, locks, sensors, scenes, automations — all through natural language.

- Skill: `malue-ai/home-assistant` (Agent Skill)
- Install (CLI): `npx skillmds@latest add malue-ai/home-assistant`
- Raw SKILL.md: https://api.skillmd.com/api/skills/malue-ai/home-assistant/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: malue-ai (https://skillmd.com/u/malue-ai)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/malue-ai/home-assistant

---


# Home Assistant — 智能家居控制

通过 Home Assistant 控制家中所有智能设备：灯光、空调、窗帘、门锁、传感器、场景、自动化等。支持 2600+ 品牌，一句话操控全屋。

## 使用场景

- 用户说「把客厅灯调暗一点」「关掉所有灯」
- 用户说「空调调到 24 度」「打开制冷模式」
- 用户说「现在家里温度多少？」「湿度多少？」
- 用户说「我要睡觉了」→ 触发 "晚安" 场景（关灯、锁门、降温）
- 用户说「帮我设个自动化：每天早上 7 点开窗帘」
- 结合 `pomodoro`：番茄钟结束时调亮灯光提醒休息
- 结合每日简报类 Skill（如已启用）：早间简报时自动调节室内环境

## 前置条件

1. 运行 Home Assistant 实例（https://www.home-assistant.io/）
2. 在 Home Assistant 中生成长期访问令牌（Long-Lived Access Token）
3. 设置环境变量：`export HOMEASSISTANT_TOKEN="your-token"`
4. 设置环境变量：`export HOMEASSISTANT_URL="http://homeassistant.local:8123"`

Home Assistant 2025.4.4+ 内置 MCP Server 支持，可直接通过 MCP 协议通信。

## 执行方式

### 通过 MCP 工具调用（推荐）

Home Assistant 提供 MCP Server 集成，通过 MCP 协议直接操作：

#### 控制设备

```
工具: call_service
参数:
  domain: "light"
  service: "turn_on"
  target:
    entity_id: "light.living_room"
  data:
    brightness_pct: 50
    color_temp_kelvin: 3000
```

#### 查询状态

```
工具: get_state
参数:
  entity_id: "sensor.living_room_temperature"
```

#### 触发场景

```
工具: call_service
参数:
  domain: "scene"
  service: "turn_on"
  target:
    entity_id: "scene.good_night"
```

### 通过 REST API 调用（备选）

```bash
# 获取所有设备状态
curl -s "$HOMEASSISTANT_URL/api/states" \
  -H "Authorization: Bearer $HOMEASSISTANT_TOKEN"

# 控制灯光
curl -s -X POST "$HOMEASSISTANT_URL/api/services/light/turn_on" \
  -H "Authorization: Bearer $HOMEASSISTANT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"entity_id": "light.living_room", "brightness_pct": 80}'

# 设置空调温度
curl -s -X POST "$HOMEASSISTANT_URL/api/services/climate/set_temperature" \
  -H "Authorization: Bearer $HOMEASSISTANT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"entity_id": "climate.bedroom", "temperature": 24}'

# 查询传感器
curl -s "$HOMEASSISTANT_URL/api/states/sensor.outdoor_temperature" \
  -H "Authorization: Bearer $HOMEASSISTANT_TOKEN"
```

### 常用设备控制模板

**灯光**：
```
开灯/关灯: light.turn_on / light.turn_off
调亮度: brightness_pct (0-100)
调色温: color_temp_kelvin (2700暖光-6500冷光)
调颜色: rgb_color [R, G, B]
```

**空调/暖通**：
```
设温度: climate.set_temperature → temperature
设模式: climate.set_hvac_mode → hvac_mode (heat/cool/auto/off)
设风速: climate.set_fan_mode → fan_mode (low/medium/high/auto)
```

**窗帘**：
```
开/关: cover.open_cover / cover.close_cover
设位置: cover.set_cover_position → position (0关-100全开)
```

**门锁**：
```
锁门: lock.lock
开锁: lock.unlock (需确认！调用 hitl 工具确认)
```

**场景**：
```
触发: scene.turn_on → entity_id: scene.xxx
```

## 安全规范

- **门锁操作**：开锁前必须通过 `hitl` 工具获得用户确认
- **安防相关**：关闭安防系统前必须确认
- **批量操作**：一次性控制 5 个以上设备时先告知用户具体操作清单
- 不主动推荐用户未拥有的设备或功能

## 与其他 Skills 的协作

| 组合 | 效果 |
|------|------|
| home-assistant + pomodoro | 番茄钟开始→调暗灯光营造专注环境；结束→调亮提醒休息 |
| home-assistant + 每日简报类 Skill（如已启用） | 早间简报时自动开灯、调温、播报天气 |
| home-assistant + reminder | 提醒事项触发时闪烁灯光辅助提醒 |
| home-assistant + scheduled-tasks | 定时自动化：每晚 11 点关灯锁门 |

## 输出规范

- 执行设备操作后简洁确认：「✅ 客厅灯已调至 50% 亮度」
- 查询状态时使用表格呈现多个传感器数据
- 批量操作给出操作清单摘要
- 设备不可达时给出故障排查建议（检查网络、重启设备）