小智AI 接入HomeAssistant方法

安装指南

前置要求

• Home Assistant 已安装并运行
• 已安装 HACS（Home Assistant Community Store）
• 小智AI账号及MCP接入点地址
  

安装步骤

1. 通过HACS安装
    1、打开 HACS，搜索 xiaozhi 或 ha-mcp-for-xiaozhi
      

1

    2、点击下载并安装插件
     

2

    3、重启 Home Assistant


2. 手动安装
如果无法通过HACS安装，可以手动下载：

• 从 GitHub Releases 下载最新版本
• 解压到 custom_components 目录
• 重启 Home Assistant
  

配置步骤

1. 添加集成

• 进入 设置 > 设备与服务 > 添加集成
• 搜索 "Mcp" 或 "MCP Server for Xiaozhi"
  

   

3

   3. 选择并点击添加

2. 配置参数
配置界面需要填写以下信息：
基本配置:

• 小智MCP接入点地址: 从小智AI后台获取的MCP接入地址
• 设备名称: 为该Home Assistant实例设置一个识别名称
  

API组选择:

• Assist: Home Assistant自带的控制功能
• 其他MCP Server: 如果你在Home Assistant中配置了其他MCP服务器，可以选择一并代理给小智
  

   

4

3. 实体公开设置
为了让小智能够控制设备，需要公开相应实体：

• 进入 设置 > 语音助手 > 公开
• 选择需要被小智控制的设备和实体
• 保存设置
  

4. 验证连接

• 配置完成后等待约1分钟
• 登录小智AI后台，进入MCP接入点页面
• 点击刷新，检查连接状态是否正常
  

   

5

使用示例

1、基础设备控制
用户: "打开客厅灯"小智: "好的，已为您打开客厅灯"用户: "把空调温度调到26度"  小智: "已将空调温度设置为26度"用户: "关闭所有灯"小智: "已为您关闭所有灯光"

2、状态查询
用户: "客厅现在的温度是多少"小智: "客厅温度传感器显示当前温度为23.5度"用户: "哪些灯现在是开着的"小智: "目前开启的灯有：客厅灯、卧室床头灯"

3、场景控制
用户: "执行睡眠模式"小智: "已为您执行睡眠模式场景，所有灯光已关闭，窗帘已拉上"用户: "开启回家场景"  小智: "欢迎回家！已为您开启客厅灯和玄关灯，空调已调至舒适温度"


调试说明

1. 实体暴露检查
暴露的工具数量取决于您公开给Home Assistant语音助手的实体种类：

• 进入 设置 > 语音助手 > 公开
• 确保需要控制的设备已添加到公开列表
  

2. 版本要求
建议使用最新版本的Home Assistant：

• 新版本提供的工具和API更加完善
• 5月版本相比3月版本在工具支持上有明显改进
  

3. 调试方法
当控制效果未达到预期时：
查看小智聊天记录:

• 检查小智如何理解和处理指令
• 确认是否调用了Home Assistant工具
• 分析调用参数是否正确
  

已知问题:

• 灯光控制可能与内置屏幕控制冲突
• 音乐控制可能与内置音乐功能冲突
• 这些问题将在下个月小智服务器支持内置工具选择后解决
  

4. 调试日志
如果Home Assistant function调用正确但执行异常：

• 在Home Assistant中开启本插件的调试日志
• 重现问题操作
• 查看日志中的详细执行情况
  

好天才！