homeassistant-assist Skill：一句话控制智能家居

🔧 Step 0：先配置消息接收渠道

⚠️ 本案例需要发送通知到你的手机，先配置消息渠道 👉 去配置 Telegram/飞书/微信接入 →

这个场景解决什么问题

直接让 AI 控制 Home Assistant 通常需要先查找设备实体 ID，调用多个 API。homeassistant-assist 技能直接调用 HA 的自然语言 Assist API，Home Assistant 自己解析实体——更省 token，更可靠。

直接复制这段命令

第一步：安装技能

clawhub install homeassistant-assist

如果安装失败（技能还未上线 ClawHub），手动安装：

git clone https://github.com/DevelopmentCats/homeassistant-assist.git \
  ~/.openclaw/workspace/skills/homeassistant-assist

然后重启 Gateway：

openclaw gateway restart

第二步：获取 Home Assistant Token

1. 打开 Home Assistant → 点左下角头像 → 个人信息
2. 滚动到底部长期访问令牌
3. 点创建令牌，命名为 “OpenClaw”
4. 立即复制（只显示一次！）

第三步：配置连接

在 ~/.openclaw/openclaw.json 中添加（或让 OpenClaw 帮你配置）：

{
  "env": {
    "HASS_SERVER": "http://homeassistant.local:8123",
    "HASS_TOKEN": "eyJ0eXAiOiJKV1QiLCJhbGc..."
  }
}

也可以直接告诉 OpenClaw：

帮我配置 Home Assistant 连接，服务器地址是 http://homeassistant.local:8123，
token 是 eyJ0eXAiOiJKV1Qi...（你的token）

重启 Gateway 使配置生效：

openclaw gateway restart

第四步：测试控制

在 Telegram 或飞书发送：

帮我关掉客厅的灯

把卧室温度设置为 24 度

打开所有走廊的灯

告诉我现在家里有哪些设备在线

远程访问配置

使用 DuckDNS + HTTPS（免费方案）：

{
  "env": {
    "HASS_SERVER": "https://your-ha-domain.duckdns.org",
    "HASS_TOKEN": "your-token"
  }
}

Nabu Casa 用户（HA Cloud）：

{
  "env": {
    "HASS_SERVER": "https://your-id.ui.nabu.casa",
    "HASS_TOKEN": "your-token"
  }
}

两种接入方式对比

方式	本文（Assist API 法）	传统实体查找法
Token 消耗	少（单次调用）	多（查询+匹配）
API 调用次数	1次	多次
可靠性	高（HA自己理解设备）	一般
配置复杂度	简单	需要熟悉实体ID

注意事项

• HASS_SERVER 必须是 OpenClaw 服务器能访问的地址
• Token 有效期很长，但如果失效需要重新生成
• 首次使用发送”列出所有可控设备”确认连接正常
• 复杂场景（如”我要睡觉了”触发一系列操作）建议先在 HA 里创建场景，再通过语言触发场景名