QClaw控制智能家居需通过SkillHub安装IoT技能、用Email技能桥接通知、本地部署Home Assistant并配置REST API，或自定义Python技能调用厂商SDK。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试通过QClaw远程操控家中智能设备，但无法实现开关灯、调节空调或读取传感器状态等操作，则可能是由于QClaw默认未内置物联网协议支持或未加载对应Skill。以下是实现QClaw控制智能家居的多种可行路径：
一、通过SkillHub安装现成物联网Skill
QClaw依托SkillHub社区提供第三方开发的技能插件，部分开发者已封装主流IoT平台（如米家、Home Assistant、涂鸦）的API调用能力，用户可直接下载启用，无需编写代码。
1、打开QClaw主界面，点击左下角「Skills」入口进入SkillHub社区。
2、在搜索栏输入关键词米家、Home Assistant或MQTT，筛选出评分≥4.5且更新时间在30天内的Skill。
3、点击目标Skill卡片，查看其依赖项说明；若提示需填写Home Assistant Long-Lived Access Token或米家账号Cookie，请提前在对应平台后台生成并复制。
4、点击「安装」后，在弹出的配置面板中粘贴凭证，并选择需同步的设备列表（如“客厅吸顶灯”“主卧空调”）。
5、保存配置，返回微信向QClaw发送指令，例如“打开客厅灯”，观察是否触发本地设备响应。
二、使用IMAP-SMTP-Email Skill桥接IoT平台通知与指令
当目标智能家居平台仅支持邮件通知（如部分安防摄像头、门磁传感器），或仅开放SMTP/IMAP接口时，可借助通用型Email Skill构建双向通道，将邮件内容解析为设备指令，或将设备状态以邮件形式回传。
1、在SkillHub中安装名为imap-smtp-email的Skill（该Skill已在实测中验证可用）。
2、在配置界面填写邮箱账户信息：包括邮箱地址、SMTP服务器（如smtp.qq.com）、端口（465）、授权码（非登录密码）及IMAP接收设置。
3、前往智能家居平台管理后台，将设备事件（如“有人移动”“门窗开启”）配置为向该邮箱发送通知邮件，并设定固定主题前缀，例如【QClaw-IoT】。
4、在微信中向QClaw发送指令：“检查【QClaw-IoT】最新邮件”，QClaw将自动拉取并解析邮件正文，提取设备类型与状态字段。
5、若需反向控制，可向同一邮箱发送含预设关键词的邮件，例如主题为【QClaw-CMD】、正文为“light_bedroom:on”，QClaw将定时轮询并执行对应动作。
三、本地部署Home Assistant并配置REST API Skill
对于具备技术基础的用户，可在家庭局域网内运行Home Assistant作为IoT中枢，利用其开放的REST API与QClaw通信；此方式不依赖云厂商，响应延迟低，且支持全部Zigbee/Z-Wave/蓝牙设备。
1、在树莓派或旧笔记本上安装Home Assistant OS，完成基础设备配对与自动化规则配置。
2、进入Home Assistant「设置 → 系统 → 集成 → RESTful」，启用REST API，并记录其访问地址（如http://192.168.1.100:8123/api/）与Long-Lived Access Token。
3、在QClaw SkillHub中搜索并安装rest-api-call技能，填写Home Assistant的API地址与Token。
4、在Skill配置中定义动作映射表，例如将自然语言指令“关闭书房空调”映射为HTTP POST请求，目标URL为http://192.168.1.100:8123/api/services/climate/turn_off，载荷为{"entity_id": "climate.shufang_kongtiao"}。
5、保存后，在微信中发送对应指令，QClaw将构造并发出REST请求，由Home Assistant转发至本地空调红外发射器或WiFi模块。
四、自定义Python Skill调用厂商SDK
针对未被主流Skill覆盖的设备（如特定型号的海信电视、格力空调SDK、大疆智能插座），可通过QClaw的Python Skill机制，直接嵌入厂商官方提供的Python SDK，实现原生协议控制。
1、确认目标设备厂商是否提供公开Python SDK（如米家SDK为miio，涂鸦SDK为tuya-iot-py-sdk），并查阅其认证方式（access token、local key、设备ID）。
2、在本地电脑创建Python文件，例如homekit_aircon.py，导入对应SDK，编写函数turn_on_ac(device_id, local_key)并确保可在命令行独立运行成功。
3、在QClaw主界面点击「Skills → 自定义Skill → 上传.py文件」，选择该脚本并填写参数映射规则，例如将微信指令“打开空调”绑定至函数调用，参数device_id从配置中读取。
4、在配置页填入设备ID、local_key、IP地址等必要字段，QClaw将在沙箱环境中执行该脚本，调用本地网络中的设备。
5、测试指令“调高空调温度2度”，观察QClaw日志是否显示SDK调用成功及设备红外反馈信号。
