home-automation¶

Skill 简介¶

OpenClaw Skill 是由 OpenClaw 提供支持的智能家居控制解决方案，旨在通过自然语言交互实现对物联网 (IoT) 设备的全面控制。它充当了用户与智能家居设备之间的桥梁，让用户可以通过 Telegram、WhatsApp 或 Discord 等即时通讯工具与家中的智能设备进行互动。无论是灯光、恒温器、门锁、摄像头，还是家庭音响系统，OpenClaw Skill 都能将其整合到一个统一的控制平台中。

对于开发者而言，OpenClaw Skill 提供了一个高度可扩展的框架，简化了智能家居自动化系统的开发流程。它不仅支持多种设备的集成，还允许开发者根据用户的具体需求自定义自动化流程和规则。通过将自然语言处理与设备控制 API 结合，OpenClaw Skill 实现了用户友好且高效的智能家居体验。

主要功能¶

1. 自然语言设备控制
OpenClaw Skill 支持用户通过自然语言命令控制各种智能家居设备。例如，用户可以说“把客厅的灯光调暗”，Skill会自动将灯光亮度调整到 30%，并将恒温器设置为 22°C，同时播放轻松的音乐歌单。该功能通过解析模糊命令并将其转换为具体的设备操作指令来实现。

2. 自动化场景管理
开发者可以为不同的场景创建自动化流程，例如早晨模式、电影之夜模式或离家模式。以下是一个示例配置：

routines:
  morning:
    - "Open bedroom blinds"
    - "Set thermostat to 21°C"
    - "Turn on kitchen lights at 80%"
  movie_night:
    - "Dim living room lights to 15%"
    - "Turn on TV"
    - "Close all blinds"
  away:
    - "Turn off all lights"
    - "Set thermostat to 18°C"
    - "Lock front door"
    - "Enable motion alerts"

3. 家庭传感器数据监控
OpenClaw Skill 可以实时监控家中的传感器数据，包括温度、湿度、运动检测以及门窗状态等。当检测到异常情况（例如门未关闭或异常运动）时，它会主动发送警报通知用户。

4. 多设备联动控制
用户可以通过单条命令同时控制多个设备。例如，用户可以说“关闭所有灯光并设置恒温器到节能模式”，Skill会自动执行相应的操作。

5. 能源消耗监测与优化建议
Skill可以生成每日或每周的能源使用报告，并提供优化建议。例如：

## Energy Report — Feb 17-23, 2026

| Device | Usage | vs Last Week |
|--------|-------|-------------|
| HVAC | 42 kWh | +8% (cold snap) |
| Lights | 12 kWh | -3% |
| Kitchen appliances | 18 kWh | +2% |
| Entertainment | 8 kWh | -15% |
| **Total** | **80 kWh** | **+1.5%** |

**Suggestion:** Your HVAC ran continuously Tuesday 2-6am when outside temp was 4°C. A scheduled setback to 17°C during sleep hours could save ~5 kWh/week.

6. 设备状态查询
用户可以随时查询设备的当前状态，例如“家里有人吗？”。Skill会检查所有传感器的数据并给出详细的回答。

使用场景¶

1. 智能家居系统集成
开发者可以将 OpenClaw Skill 集成到现有的智能家居系统中，以提供更便捷的用户交互方式。例如，用户可以通过 Telegram 向家中的设备发送指令，而无需依赖专用的移动应用。

2. 语音助手扩展
OpenClaw Skill 可以作为语音助手的扩展模块，为其提供更强大的设备控制能力。例如，将 Skill 与 Google Assistant 或 Amazon Alexa 结合，用户可以通过语音命令更灵活地控制家中的设备。

3. 家庭自动化平台开发
对于希望开发定制化家庭自动化平台的开发者，OpenClaw Skill 提供了一个功能丰富的框架，可以根据用户需求快速构建复杂的自动化流程。

4. 能源管理解决方案
开发者可以利用 Skill 的能源监控功能，为用户提供智能化的能源管理方案，帮助用户优化能源使用，降低能耗成本。

5. 安防系统集成
OpenClaw Skill 可以与家庭安防系统结合，提供实时监控和警报功能。例如，当检测到异常运动时，Skill 会自动发送通知并触发警报。

如何使用¶

安装与配置¶

前置条件
已安装 Home Assistant 并配置好相关设备。
已创建 Telegram、WhatsApp 或 Discord 机器人，并获取 API 密钥。
安装依赖
bash pip install openclaw
配置文件
创建一个 config.yaml 文件，并添加以下内容：

```yaml
home_assistant:
url: "http://homeassistant.local:8123"
token: "YOUR_LONG_LIVED_ACCESS_TOKEN"

devices:
living_room:
lights: "light.living_room_main"
tv: "media_player.living_room_tv"
speaker: "media_player.sonos_living"
thermostat: "climate.living_room"
bedroom:
lights: "light.bedroom_main"
fan: "fan.bedroom_ceiling"
blinds: "cover.bedroom_blinds"

routines:
morning:
- "Open bedroom blinds"
- "Set thermostat to 21°C"
- "Turn on kitchen lights at 80%"
movie_night:
- "Dim living room lights to 15%"
- "Turn on TV"
- "Close all blinds"
away:
- "Turn off all lights"
- "Set thermostat to 18°C"
- "Lock front door"
- "Enable motion alerts"
```

启动 Skill
bash openclaw --config config.yaml --telegram-token YOUR_TELEGRAM_BOT_TOKEN

代码示例¶

以下是一个简单的 Python 示例，展示如何使用 OpenClaw Skill 控制设备：

from openclaw import OpenClaw

# 初始化 OpenClaw
skill = OpenClaw(config_path='config.yaml')

# 发送命令
skill.send_command("Make the living room cozy")

# 查询设备状态
status = skill.get_status("living_room")
print(status)

示例¶

示例 1：执行自动化场景¶

用户命令： “开始电影之夜模式”

Skill响应：

Running "movie night" routine:
- Living room lights → 15% ✓
- TV → on ✓
- All blinds → closed ✓
Enjoy your movie!

示例 2：查询能源使用情况¶

用户命令： “显示本周能源使用情况”