22如何通过小智AI语音控制HA设备，小白教程

admin · 发表于 2026-4-8 11:01:04

Home Assistant (HA) 中通过HACS安装 MCP Server for Xiaozhi , 然后再集成添加插件 MCP Server for Xiaozhi（我们2026年4月后出去的主机已经完成了本步骤配置）

第一步：获取小智的“MCP 接入点地址”

小智设备需要一个通信地址才能跟你的 HA 连上，这个地址在小智的云端控制台里获取[2][3]。

电脑或手机浏览器打开并登录 小智官方控制台（通常是 xiaozhi.me，如果是自部署的则打开你自己的控制台地址）[2][3]。
在设备列表中，找到你目前正在使用的那台 ESP 小智设备，点击 配置 (Configure)[3]。
页面向下滑动，找到 “MCP 设置” (MCP Setting) 区域[3]。
点击 “获取 MCP 接入点” (Get MCP Endpoint)，此时会生成一串链接（通常以 wss:// 开头），复制这串地址备用[2][3]。

第二步：在 HA 中配置小智 MCP 集成

现在我们要把刚才复制的地址填入 HA 中，让 HA 主动去连接小智服务器[1]。

打开 Home Assistant 面板，点击左侧边栏的 配置 / 设置 (Settings)。
点击 设备与服务 (Devices & Services)。
点击右下角的 添加集成 (Add Integration)[3]。
在搜索框输入 MCP 或 Xiaozhi，找到 MCP Server for Xiaozhi 并点击[1][3]。
填写配置项：
- 小智MCP接入点地址：粘贴你在第一步复制的那串链接[1]。
- 选择需要的 MCP（如果出现 llm_hass_api 复选框）：一定要勾选 。这是 HA 自带的控制功能，勾选后 HA 才能把家里的设备控制权“代理”交给小智[1]。如果你在 HA 里还有其他 MCP 也可以一并勾选。
点击 提交 / 完成[1]。
检查状态：耐心等待一分钟左右，回到小智控制台的 MCP 设置页面，点击刷新，看看状态是否已经变为“已连接”[1]。

第三步：把 HA 的设备“公开”给小智（关键！）

如果直接对小智喊“开灯”，它可能会说找不到设备，因为出于安全考虑，HA 默认不会把所有设备都暴露给语音助手[1]。

在 HA 面板中，进入 设置 (Settings) -> 语音助手 (Voice assistants)[1]。
找到 公开 (Expose) 选项卡[1]。
在这里你会看到你家里的各种设备列表。勾选你想让小智控制的设备（比如具体的灯、开关、空调、风扇、温湿度传感器等）[1][3]。
建议小白一开始只勾选 1-2 个灯测试，测试成功后再把其他设备勾选上。

第四步：语音测试与调试

全部配置完毕，你可以开始对小智下达指令了！

遇到问题怎么排查（避坑指南）：

小智没反应/乱回答：去小智的云端控制台，查看“聊天记录”[1]。看看小智有没有听懂你的话，以及它有没有尝试调用 Home Assistant 的工具（Function Call）[1]。
指令冲突：目前小智端如果开启了“内置的音乐/屏幕控制逻辑”，可能会与 HA 的灯光和音乐控制产生冲突。如果在控制灯光时经常失败，可以尝试把对话指令说得更具体，例如“通过智能家居把客厅的吸顶灯打开”[1]。
HA日志：如果小智确实发出了指令，但设备没动静，可以去 HA 的设置 -> 系统 -> 日志中查看 MCP 插件是否有报错信息[1]。

按照以上四步，你的小智 AI 就能顺利化身为真正的“家庭智能管家”了！

jdkjzhg · 发表于昨天 10:38

		自动登录	找回密码
密码			立即注册