模板: HA树莓派配置指南
来自Waveshare Wiki
HA 配置指南
树莓派上配置HA系统
一、使用 Raspberry Pi Imager 烧写最新官方镜像
- 将 TF 卡连接到 PC，下载并使用 Raspberry Pi Imager 工具烧录对应的系统镜像。
- 烧写完成后，将 TF 卡插入树莓派，并连接网线和电源。
- 使用 HDMI 屏幕连接树莓派，在屏幕上可以读取到系统分配的 IP 地址。
- 在同一局域网下的电脑浏览器中输入以下地址：
http://<树莓派IP>:8123/
（例如 http://192.168.253.107:8123/ ，请根据实际 IP 替换，或者直接访问：http://homeassistant.local:8123/ ）
- 首次进入页面时，会提示 “正在准备 Home Assistant”，根据您的硬件和网络连接情况，准备过程可能需要一些时间。
此时Home Assistant正在下载最新版本的Home Assistant Core（约 700 MB）。
- 等待初始化完成后，点击“创建我的智能家居”继续设置。
二、安装Advanced SSH & Web Terminal
- 打开设置 -> 加载项
- 在搜索栏输入 Advanced SSH & Web Terminal，点击安装
- 等待安装完成后，点击配置，设置Advanced SSH & Web Terminal登录密码
三、安装HACS (Home Assistant Community Store)
HACS 不是加载项，而是自定义集成，需要通过终端命令安装。
- 打开Advanced SSH & Web Terminal终端：
- 在终端输入以下命令:
wget -O - https://get.hacs.xyz | bash -
- 执行完成后，重启 Home Assistant。
reboot
- 系统重新启动后，进入设置 -> 设备与服务
- 点击右下角“添加集成”
- 搜索HACS，点击进入
- 点击链接，验证并登录Github账号（需要自行注册）
- 绑定成功：
四、接入米家设备
- 打开HACS，在搜索栏输入并安装以下两个集成：
- Xiaomi Miot Auto
- Xiaomi Gateway 3
- 安装完成后，进入设置 -> 设备与服务 -> 添加集成，在搜索栏输入：xiaomi
- 按照界面提示，登录已经绑定米家设备的小米账号（需要提前注册）
小智语言控制接入HA的设备
需要先保证小智可以正常应答，保证HA网页可以正常控制设备
小智MCP接入
- 进入HACS，搜索xiaozhi，下载MCP Server for Xiaozhi
- 下载成功后，进入设置 -> 设备与服务 ->添加集成->搜索并添加 MCP Server for Xiaozhi
- 获取小智MCP接入地址，浏览器进入 https://xiaozhi.me/console/agents
点击配置角色 -> 获取 MCP 接入点
复制URL
将复制好的地址粘贴到刚才HA的配置中
此时回到小智配置界面刷新，接点接入状态会显示在线。
控制优化
小智推荐使用deepseek模型
- 在 Home Assistant 网页中进入：
设置->语音助手->公开->助手
即可给设备设置别名
- 完成设置后重启设备，即可与小智对话，例如：
- 小智，办公室里有哪些设备？
- 帮我打开台灯。
- 小智，办公室里有哪些设备？
ScreenKey 本地接入 HA 设备
创建令牌
在 HA 网页中进入：
用户 → 安全 → 创建令牌
配置令牌
- 将生成的令牌复制，并在 ScreenKey 软件中粘贴到令牌输入框。
- 点击 保存配置，如果配置正确会显示 “已连接”。
- 如果是局域网环境，IP 地址无需修改；如果不是，请将 homeassistant.local 替换为实际的 IP 地址。