【OpenClaw全面解析：从零到精通】第41篇：OpenClaw + Home Assistant 智能家居实战：飞书一句话控制全屋设备，打造真正的 AI 管家

上一篇【第40篇】OpenClaw IDE集成深度指南——从VSCode插件到ACP协议让AI Agent驱动编辑器实战下一篇【第42篇】OpenClaw RAG知识库智能客服实战用向量检索打造懂业务的AI助手明日更新敬请期待摘要OpenClaw Home Assistant的智能家居集成方案正在成为 2026 年最受关注的本地化 AI 落地场景之一。通过ha-mcp技能插件搭建飞书 → OpenClaw → ha-mcp → Home Assistant → 米家/SwitchBot/HomeKit全链路你只需在飞书或钉钉、微信等渠道发送自然语言指令即可控制全屋 34 类智能设备实现把卧室调成睡眠模式而非仅仅关灯的复杂场景联动。本文提供从零搭建到生产部署的完整实战指南包含环境准备、ha-mcp 安装与配置、多平台设备接入、场景联动编写、Cron 自动化调度以及隐私安全最佳实践。一、为什么 AI 智能家居需要 OpenClaw1.1 传统智能家居的三大痛点2026 年国内智能家居市场迎来了爆发式增长——小米发布 miloco AI 智能家居系统、SwitchBot 推出原生 AI Hub、Home Assistant 社区持续壮大。然而绝大多数用户仍然面临三个核心痛点指令刚性语音助手只能执行预设命令无法理解营造一个适合深度工作的氛围这类语义指令平台孤岛小米设备、Apple HomeKit、SwitchBot、涂鸦Tuya等各自为政联动逻辑复杂缺乏长期记忆每次交互都是独立事件AI 不知道你昨天说以后周五晚上 8 点播放爵士乐什么是 OpenClaw 智能家居方案OpenClaw 智能家居方案是通过ha-mcpHome Assistant MCP 技能将 OpenClaw AI Agent 与 Home Assistant 家庭自动化平台连接使 AI 能够以自然语言查询设备状态、执行控制指令、编排自动化场景并结合 OpenClaw 的记忆系统记住用户偏好。这是一套完全本地化、隐私可控、可扩展的智能家居 AI 解决方案。1.2 OpenClaw 方案的核心价值OpenClaw 打破了上述三大痛点痛点传统方案OpenClaw 方案指令刚性固定关键词匹配LLM 语义理解支持模糊意图平台孤岛各 App 独立控制HA 统一管理OpenClaw 统一入口长期记忆无QMD/Active Memory 记住用户习惯接入渠道专用 App飞书、钉钉、微信、Telegram 等 20根据知乎用户2026-03-16的实测报告通过飞书接入 OpenClaw 控制小米设备平均响应时间 1.2 秒指令理解准确率超过92%远超传统语音助手小爱同学约 78%。1.3 技术架构全览用户发送消息飞书/钉钉/微信 │ ▼ OpenClaw Gateway ┌──────────────────────────────────────┐ │ Agent LoopLobster Loop │ │ 理解意图 → 选择工具 → 执行动作 → 返回结果 │ │ │ │ ha-mcpMCP 技能 │ │ 34 类工具灯光/空调/门锁/媒体... │ └──────────────────────────────────────┘ │ REST API / WebSocket ▼ Home Assistant (本地局域网) │ ┌─────┼─────┬──────────────┐ ▼ ▼ ▼ ▼ 米家 SwitchBot HomeKit 涂鸦(Tuya)二、环境准备Home Assistant 与 OpenClaw 安装2.1 Home Assistant 安装快速版Home Assistant以下简称 HA是智能家居的中枢大脑支持 3,000 集成和全平台部署。推荐安装方式按场景选择方式适用场景特点Home Assistant OS树莓派家庭专用服务器功能最全支持 Add-onsDocker 部署已有 Linux 服务器轻量灵活易于迁移群晖 NAS 部署已有 NAS 用户节省单独设备成本Docker 快速安装# 创建数据目录mkdir-p/opt/homeassistant# 启动 Home Assistantdockerrun-d\--namehomeassistant\--privileged\--restartunless-stopped\-eTZAsia/Shanghai\-v/opt/homeassistant:/config\--networkhost\ghcr.io/home-assistant/home-assistant:stable# 访问http://YOUR_IP:8123安装完成后完成初始配置向导并获取长期访问令牌Long-Lived Access TokenHome Assistant → 用户头像 → 安全 → 创建令牌 → 名称openclaw-token → 复制令牌值只显示一次请保存好2.2 OpenClaw 安装与飞书接入如果你已有 OpenClaw可以跳过此步。新用户参考以下快速安装# 全局安装 OpenClawnpminstall-gopenclaw# 初始化配置openclaw start# 验证运行openclaw doctor飞书渠道配置最常用的国内渠道# openclaw.yamlchannels:feishu:enabled:trueapp_id:your-feishu-app-idapp_secret:your-feishu-app-secretverification_token:your-verification-tokenencrypt_key:your-encrypt-key# 可选建议开启webhook_url:https://your-domain.com/channel/feishu国内用户提示OpenClaw 默认通过 Anthropic/OpenAI 接口工作国内建议配置中转代理或使用 DeepSeek/通义千问等国产大模型参见第 026 篇。三、ha-mcp 技能OpenClaw 的智能家居接管层3.1 什么是 ha-mcp什么是 ha-mcpha-mcp是一个 OpenClaw 技能Skill通过 Model Context ProtocolMCP协议将 Home Assistant 的 REST API 封装为 AI 可调用的工具集使 OpenClaw Agent 能够以自然语言查询和控制家庭自动化设备。ha-mcp支持 34 类工具覆盖灯光、气候、门锁、媒体播放器、传感器、场景激活、自动化触发等主要设备类别来源ClawSkills.sh2026-02-28。支持的 34 类工具一览类别工具数量典型操作灯光light8开关、亮度、色温、颜色气候climate5设置温度、模式切换、风速门锁lock3锁定、解锁、查询状态媒体播放media_player6播放/暂停、音量、切换来源开关switch3开/关、查询状态传感器sensor4温湿度、电量、运动检测场景scene2激活场景自动化automation3触发、启用/禁用自动化3.2 安装 ha-mcp 技能方式一ClawHub 一键安装推荐# 通过 OpenClaw CLI 安装openclaw skillsinstallha-mcp# 或通过飞书/微信对话安装# 发送消息/skill install ha-mcp方式二手动配置 MCP# openclaw.yaml - 手动配置 ha-mcp MCP 服务器mcp:servers:home-assistant:command:uvxargs:-mcp-hassenv:HASS_URL:http://192.168.1.100:8123# HA 地址HASS_TOKEN:your-long-lived-access-token安全提示HA 令牌具有完全访问权限建议使用环境变量或加密存储不要直接写入 YAML 文件。方式三使用 techartdev/OpenClawHomeAssistant 专属 Add-on如果你使用 Home Assistant OS可以直接安装官方 Add-onHA → Add-on 商店 → 搜索 OpenClaw → 安装 OpenClaw Assistant Add-on → 配置 OpenClaw API 密钥 → 启动3.3 技能配置文件详解# ~/.openclaw/skills/ha-mcp/SKILL.md 配置核心字段name:ha-mcpversion:2.4.0description:|Controls Home Assistant smart home devices and queries device states. Supports 34 tools including lights, climate, locks, media players.# MCP 服务器配置mcp:server:home-assistant# 工具激活按需选择tools:-light_turn_on-light_turn_off-light_set_brightness-light_set_color_temp-climate_set_temperature-climate_set_hvac_mode-lock_lock-lock_unlock-media_player_play-media_player_pause-media_player_volume_set-scene_turn_on-sensor_get_state-automation_trigger# 设备别名让 AI 理解你家的设备名称aliases:客厅灯:light.living_room主卧空调:climate.master_bedroom_ac大门:lock.front_door电视:media_player.living_room_tv睡眠模式:scene.sleep_mode四、设备接入实战小米、SwitchBot、HomeKit 三大平台4.1 小米米家设备接入小米米家是国内用户最常用的智能家居生态通过 Home Assistant 的xiaomi_miot集成支持 300 米家设备步骤一安装 Xiaomi Miot Auto 集成# configuration.yaml 或 HA UI 配置# HA → 设置 → 设备与服务 → 添加集成# 搜索Xiaomi Miot Auto# 输入小米账号和密码建议使用小号步骤二配置设备实体HA 自动发现米家设备后给关键设备配置友好名称# configuration.yamlhomeassistant:customize:light.xiaomi_light_001:friendly_name:客厅主灯climate.xiaomi_ac_002:friendly_name:卧室空调media_player.xiaomi_tv:friendly_name:小米电视步骤三OpenClaw 自然语言控制演示配置完成后在飞书发送用户把客厅亮度调到 60%色温设为暖白 OpenClaw好的正在调整客厅灯光... 已将客厅主灯亮度设为 60%153/255色温设为 3000K暖白当前状态✅ 开启飞书→小米电视全链路实测基于知乎用户三天实测报告2026-03-16链路飞书消息 → OpenClaw Gateway → ha-mcp → Home Assistant → xiaomi_miot → 小米电视 用户切换到优酷播放《三体》 时延约 1.4 秒局域网环境 准确率14/15 次93.3%4.2 SwitchBot 设备接入SwitchBot 是海外和国内都颇受欢迎的智能家居品牌原生支持 Home Assistant# HA 配置# 设置 → 设备与服务 → 添加 SwitchBot 集成# 输入 API Token 和 Secret# SwitchBot 设备自动注册后配置 OpenClaw 别名# openclaw.yamlagents:default:skills:ha-mcp:aliases:床头灯:light.switchbot_bulb_bedroom窗帘:cover.switchbot_curtain_living温控器:climate.switchbot_hub_thermo根据 openclaws.io 2026-02-23 的报道SwitchBot Hub 2 已原生支持 OpenClaw AI 控制硬件层直接集成 LLM 理解能力无需经过 Home Assistant 中转延迟降低至约0.8 秒。4.3 Apple HomeKit 设备接入通过 HA 的 HomeKit Device 集成可以将 iPhone/iPad 里的 HomeKit 设备统一接入 OpenClaw 管控# HA → 设置 → 添加 HomeKit Device 集成# 扫描或输入配对码# 典型 HomeKit 设备接入后的控制# 飞书消息用户打开窗帘 30%温度设为 26 度 OpenClaw ✅ 客厅窗帘 → 已开启 30%HomeKit Cover ✅ 卧室空调 → 已设置 26°C 制冷模式HomeKit Thermostat三大平台对比平台优势注意事项最低延迟小米米家设备丰富国内最广泛需要小米账号偶有 Token 过期1.2sSwitchBot支持传统设备改造无需换设备API 调用有频率限制每日 1万次0.8sApple HomeKit稳定可靠隐私保护好设备价格偏高生态相对封闭1.5s五、场景联动让 AI 理解复杂指令5.1 自然语言场景匹配传统智能家居语音助手的最大局限是指令刚性——必须说打开客厅灯不能说开一下灯。OpenClaw 配合 LLM 彻底解决了这个问题示例对话实测场景用户我要睡觉了 OpenClaw好的帮你准备睡眠环境... ✅ 客厅灯 → 已关闭 ✅ 卧室灯 → 亮度 10%色温 2700K夜间模式 ✅ 空调 → 已设置 26°C 睡眠模式3小时后降至25°C ✅ 电视 → 已关闭 ✅ 已激活睡眠模式场景 用户下次我说睡觉的时候也这样 OpenClaw好的我已记住这个偏好以后说睡觉了会自动执行这套流程。 [Active Memory 记录用户偏好]5.2 在 HA 中创建自定义场景配合 HA 场景功能可以预设复杂的设备组合# configuration.yaml 或 HA 场景编辑器scene:-name:工作模式entities:light.office_main:state:onbrightness:220color_temp:4000climate.office_ac:state:cooltemperature:24media_player.office_speaker:state:off-name:睡眠模式entities:light.bedroom_main:state:onbrightness:25color_temp:2700light.living_room:state:offclimate.bedroom_ac:state:sleeptemperature:26switch.tv_main:state:off-name:回家模式entities:light.entrance:state:onbrightness:255climate.living_room_ac:state:cooltemperature:25media_player.living_room_tv:state:onsource:优酷5.3 基于传感器的智能联动结合 HA 传感器数据OpenClaw 可以根据实时环境做出决策场景根据室内 CO₂ 浓度自动提醒开窗# openclaw.yaml - 环境感知 Skillskills:air-quality-guardian:description:监控室内空气质量超标时提醒用户开窗# 定时检查每30分钟cron:*/30 * * * *prompt:|查询 sensor.co2_living_room 的当前值。 如果 CO₂ 浓度超过 1000ppm通过飞书发送提醒消息 客厅 CO₂ 浓度当前为 {value}ppm已超过健康标准1000ppm 建议开窗通风 15 分钟并尝试打开智能窗户。场景门铃响起自动通知并截图# openclaw.yaml - 门铃联动hooks:on_sensor_state_change:entity_id:binary_sensor.doorbellstate:onactions:-notify:channel:feishumessage:有人按门铃了 正在获取门口监控画面...-ha_action:service:camera.snapshotentity_id:camera.front_doorsave_to:/tmp/doorbell_{{timestamp}}.jpg-send_image:channel:feishupath:/tmp/doorbell_{{timestamp}}.jpg六、Cron 自动化让 OpenClaw 成为你的家庭管家6.1 早晨唤醒流程# openclaw.yaml - 工作日早晨唤醒schedule:morning_routine:# 工作日 7:00 执行cron:0 7 * * 1-5actions:prompt:|执行早晨唤醒流程 1. 渐进开启卧室灯亮度从0逐步升至100%历时10分钟 2. 将卧室温度调整为 24°C 3. 打开厨房灯 4. 通过飞书发送今日天气和日程简报 5. 如果今天有会议提前30分钟发送提醒# 需要天气和日历工具tools:-ha-mcp-weather-skill-feishu-calendar6.2 离家/回家自动检测通过手机定位触发实现无感自动化# openclaw.yaml - 离家自动化hooks:on_device_tracker_update:entity_id:device_tracker.your_phone# 离家时on_away:prompt:|用户已离开家请检查并执行 1. 关闭所有灯光检查每个区域 2. 关闭空调若无其他人在家 3. 锁定前门 4. 打开安防模式 5. 发送飞书消息确认已确认您离家所有设备已关闭 # 接近家时距离500米内on_home:prompt:|用户即将到家距离约500米提前准备 1. 打开玄关灯 2. 夏季提前5分钟开启客厅空调制冷25°C 3. 冬季提前5分钟开启地暖 4. 发送消息检测到您快到家了已为您准备好环境 6.3 周末模式与节能调度# openclaw.yaml - 节能调度schedule:# 工作日晚10点后切换节能模式night_energy_save:cron:0 22 * * 1-5prompt:|切换到夜间节能模式 - 将所有灯光亮度降至 30% - 空调温度上调 1°C制冷模式 - 关闭非必要设备如工作灯 - 发送日耗电统计报告# 周末早上9点weekend_morning:cron:0 9 * * 6,7prompt:|周末早上好执行周末唤醒流程 - 缓慢开启全屋灯光亮度70% - 播放周末音乐清单media_player.living_room来源Apple Music - 温度设为 25°C - 发送今日新闻摘要和天气预报七、隐私安全与部署最佳实践7.1 本地化部署的隐私优势OpenClaw Home Assistant 方案最重要的优势之一是本地化。家庭设备数据全程在本地网络流通不经过云端服务器设备状态 → Home Assistant本地 → ha-mcp → OpenClaw本地 ↕ LLM 推理可本地化 ↕ 飞书消息加密传输若要完全本地化不使用云端 LLM推荐配置# openclaw.yaml - 完全本地化方案providers:default:# 使用本地 Ollama 模型api:http://localhost:11434model:llama3:70b# 需要至少 64GB 内存# 或使用 LM Studioapi:http://localhost:1234/v1model:qwen2.5-72b-instruct7.2 HA Long-Lived Token 安全管理# ❌ 不安全直接写入配置文件HASS_TOKEN:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...# ✅ 安全使用环境变量# 在 ~/.openclaw/.env 文件HASS_URLhttp://192.168.1.100:8123HASS_TOKENeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...# openclaw.yaml 引用环境变量mcp: servers: home-assistant: env: HASS_URL:${HASS_URL}HASS_TOKEN:${HASS_TOKEN}7.3 权限最小化原则建议为 OpenClaw 创建专用 HA 账户限制其权限范围# HA → 管理员账户 → 创建子账户openclaw-bot# 限制访问的实体组不包括安全摄像头、密码类传感器等# HA - groups.yaml已废弃但可类比于 Label 过滤openclaw_allowed_domains:-light-climate-media_player-scene-switch# 不包括camera, alarm_control_panel, lock除非明确授权7.4 生产部署网络安全配置# openclaw.yaml - 安全加固gateway:# 仅允许本地网络访问 HA 端点allowedHosts:-192.168.0.0/24# 本地局域网# 飞书 webhook 签名验证channels:feishu:verify_signature:truesignature_key:${FEISHU_SIGN_KEY}# 设置 requireApproval 避免误操作高危设备skills:ha-mcp:requireApproval:-lock_unlock# 解锁操作需人工确认-alarm_disarm# 解除安防需人工确认八、常见问题解答FAQQ1ha-mcp 连不上 Home Assistant 怎么办A首先检查以下几点HASS_URL是否为局域网 IP如http://192.168.1.100:8123而非localhostDocker 容器网络隔离Long-Lived Access Token 是否过期有效期通常为永久但可能被手动撤销HA 防火墙是否允许 OpenClaw 所在 IP 访问 8123 端口运行curl -H Authorization: Bearer YOUR_TOKEN http://192.168.1.100:8123/api/测试连通性Q2如何让 OpenClaw 记住我的设备习惯A在对话中直接告诉 OpenClaw用户以后每天晚上 10 点把客厅灯调暗到 20% OpenClaw好的我已添加每日定时任务 Cron: 0 22 * * * 操作将 light.living_room 亮度设为 20% [已写入 openclaw.yaml 的 schedule 配置]或者明确说记住这个习惯OpenClaw 会通过 Active Memory 记录。Q3控制米家设备经常出现实体不可用怎么办A这通常是 xiaomi_miot 集成的 Token 过期问题# HA → 设置 → 设备与服务 → 小米 Miot Auto → 重新认证# 或删除并重新添加集成另外米家服务器在国内有时会限速建议设置request_timeout: 30并添加重试逻辑。Q4可以用手机定位控制离家/回家自动化吗A支持。推荐以下方案iPhone 用户使用 Home Assistant Companion App支持精确定位触发Android 用户同样支持 HA Companion App无手机追踪可用路由器 MAC 地址检测适用于家庭路由器Q5飞书机器人响应太慢超过 3 秒怎么优化A响应时间超过 3 秒通常有以下原因LLM 推理慢切换到更快的模型Haiku Sonnet Opus或使用本地 Qwen/DeepSeekHA 响应慢检查 HA 主机性能建议至少 4 核 CPU 4GB 内存网络延迟确保 OpenClaw 与 HA 在同一局域网避免走公网中转九、进阶OpenClaw 与 ha-mcp 的未来演进9.1 语音控制配合 v2026.4.15 Gemini TTS结合 v2026.4.15 引入的 Gemini TTS 能力可以构建语音反馈闭环# 语音控制智能家居channels:voice:provider:googlemodel:gemini-tts-2voice_id:zh-CN-Neural2-A# 收到指令后语音播报执行结果hooks:after_ha_action:tts:enabled:truetemplate:好的{{action_description}}已完成9.2 视觉理解门口摄像头分析结合 v2026.4.10 的 Active Memory 和图像理解能力# 摄像头内容理解技能skills:vision-security:trigger:camera.front_door 检测到运动prompt:|获取 camera.front_door 的截图分析 1. 是否是认识的人与已知家庭成员照片比对 2. 是否有可疑行为 3. 根据分析结果决定是否发送警报通知总结OpenClaw Home Assistant智能家居方案代表了 2026 年本地化 AI Agent 应用的最佳实践之一本地优先、隐私可控、语义理解、记忆进化。通过ha-mcp技能的 34 类工具OpenClaw 能够以自然语言控制小米米家、SwitchBot、HomeKit 等主流平台的全屋设备结合 Cron 定时任务和传感器联动真正实现了早上说’我要起床了’全屋自动进入唤醒模式的智能体验。与小米 miloco、Google Home 等封闭式方案相比OpenClaw HA 最大的优势是开放可编程——你能用一句自然语言创建复杂的联动规则并通过 Active Memory 让系统持续学习你的偏好。这不仅是一个更智能的语音助手更是一个真正意义上的AI 家庭管家。上一篇【第40篇】OpenClaw IDE集成深度指南——从VSCode插件到ACP协议让AI Agent驱动编辑器实战下一篇【第42篇】OpenClaw RAG知识库智能客服实战用向量检索打造懂业务的AI助手明日更新敬请期待参考资料OpenClaw Home Assistant 技能 - ClawSkills.shGitHub - techartdev/OpenClawHomeAssistantGitHub - daniel-luke/openclaw-ha-pluginOpenClaw 走进你的家AI 驱动智能家居控制的崛起 - openclaws.ioOpenClaw Home Assistant用AI Agent让智能家居真正智能 - EastonDev飞书→OpenClaw→ha-mcp→米家→小米电视全链路实测 - 知乎Home Assistant AI 控制使用 Openclaw Skills 管理智能家居 - ToolifyA new Home Assistant Skill for OpenClaw - HA CommunityHome Assistant 官方文档OpenClaw 官方文档