『瀚思彼岸』» 智能家居技术论坛

标题: AI语音-教程-小智全模块服务搭建入门到入土 [打印本页]

作者: 爱捣鼓的哈哥    时间: 2025-5-12 19:21
标题: AI语音-教程-小智全模块服务搭建入门到入土
本帖最后由 爱捣鼓的哈哥 于 2025-5-12 19:31 编辑





今天我带来的是小智全量版的设置教程,并整理了说明文档,方便大家更好的学习。


先科普一下什么是全量版(先更名为“全模块安装”,以后教程按官方更名后方式描述)


[attach]69727[/attach]


在冬瓜HAOS中,是可以看到“最简化安装”和“全模块安装”,因为在HomeAssistant的运行规则和方便管理,导致把每个功能都独立出来了即“小智 AI Server 最简化版”、“小智 AI 智控台”、“Redis Server”和“MariaDB”。


最简化安装”就是冬瓜加载项商店中的“小智 AI Server 最简化版”(下称最简版),里面包含了“智能对话、IOT功能,数据存储在配置文件”,是最基础、低配的运行环境。


冬瓜加载项商店中的"小智 AI 智控台"(下称智控台)包含官方所说的“OTA、智控台”可以本地化管理小智音箱和OTA升级。


Redis Server”和“MariaDB”是必要的运行组件,这里就不过多赘述。


大家可能还发现加载项商店里有一个“小智 AI Server 极速版”(下称极速版),这个是冬瓜大神为了大家快速的体验小智音箱做的一个加载项。主打一个快速便捷,也比较适合小白,简单设置一下就能使用。但是更个性化的修改会很麻烦,而且有一些功能限制。


录制教程中注册豆包模型的相关操作可以参考视频HomeAssistant玩转小智服务器全量版。为了便于排版和视频流程有一些出入,但是不影响最终的效果。


好了,下面我们进入正题!


一、全模块安装


1、在HA中,选择设置 -> 加载项 -> 加载项商店 ,找到并安装小智 AI Server 最简化版小智 AI 智控台Redis ServerMariaDB


二、设置


1、MariaDB设置


1.1 进入MariaDB 的配置页中,在“Databases”里增加下面内容,然后回车


xiaozhi_esp32_server

1.2 在“Logins”修改数据库密码为root,(建议新手先按我的流程进行设置,后再改成复杂的密码)


- password: root

1.3 在“Rights”回车新建一行粘贴以下内容


- database: xiaozhi_esp32_server
  username: homeassistant

1.4 点击 保存。


1.5 返回信息页启动它,需要启动两次!需要启动两次!需要启动两次!,第一次并没有把小智数据库写进入。


1.6 建议看一下日志,看看有没有什么报错导致无法启动的情况。


[attach]69728[/attach]


2、 Server设置


2.1 无需额外设置,直接启动就好。


2.2 查看日志


[attach]69729[/attach]


3、小智 AI 智控台设置


3.1 如MariaDB和叫的教程一样则跳过配置环节。如修改了任何参数需要与MariaDB配置一致。


3.2 进入智控台 启动。


3.3 查看日志


[attach]69730[/attach]


3.4 启动完成后进入信息页,点击打开网页界面。


3.5 第一次进入智控台需要先注册用户,第一个用户是管理员权限。


3.6 输入用户名、密码、确认密码、验证码后点击立即注册。


3.7 进入模型配置找到豆包大模型,设置为默认并点击修改


3.8 新建一个网页,登录到火山引擎,进入到[开通管理](https://console.volcengine.com/a ... openManagement?LLM={}&OpenTokenDrawer=false),我开通的是”Doubao-1.5-pro-32k“,点击蓝色模型名进入到模型信息页,点击复制按钮,


[attach]69732[/attach]


3.9 返回到智控台粘贴到模型名称栏中。


3.10 返回火山引擎,导航栏找到API Key 管理,创建API Key -> 创建 -> 显示 -> 复制,。


[attach]69734[/attach]


3.11 返回到智控台粘贴到API密钥栏中,点击保存。


[attach]69733[/attach]


3.12  进入语言识别找到豆包语言识别,设置为默认并点击修改


3.13  新建一个网页,进入到语音技术,点击创建应用,输入应用名称应用简介,勾选 大模型语音合成语音合成音色转换办公中文通用中文,点击确定。


[attach]69735[/attach]


3.14 左侧栏找到语音合成大模型 ,确认已开通,实例状态显示“运行中”。点击APP ID下面的复制图标。


[attach]69736[/attach]


3.15 返回到智控台粘贴到应用ID栏中。


3.16 返回刚才的网页,找到 Access Token鼠标放在下面一串*,点击后面的显示图标和复制图标。


3.17 返回到智控台粘贴到访问令牌栏中,点击保存。


[attach]69737[/attach]


3.18 进入语音合成找到豆包语言合成,设置为默认并点击修改


3.19 在访问令牌栏中粘贴刚才的Access Token(和刚才使用一个令牌),应用ID也是使用刚才的APP ID,点击保存。


[attach]69738[/attach]


3.20 进入意图识别,找到函数调用意图识别,设置为默认并点击修改,在函数列表后面粘贴下面的参数(注意分号!),点击保存。


;hass_get_state;hass_set_state

[attach]69739[/attach]


3.21 进入记忆,找到本地短期记忆,设置为默认


3.22 找到参数字典 -> 参数管理 进入第三页向下滚动找到Home Assistant API密钥点击编辑


3.23 返回HA,点击用户名  -> 安全  -> 长期访问令牌  ->  创建令牌  -> 输入名称  ->  点击复制图标,返回智控台粘贴到参数值内,点击保存。


[attach]69740[/attach]


3.24 找到天气插件默认城市点击编辑,参数值改为你所在的城市。


3.25 返回到 第一页找到server.secret查看复制


[attach]69741[/attach]


4、小智 AI Server 最简化版设置


4.1 新建打开一个浏览器进入HA,加载项中找到最简版,点击运行,让服务将默认文件写的相应的路径中。


4.2 进入Filebrowser(没有安装去加载项商店里安装即可,进入点击Settings -> Language可以改为中文)


4.3 找到 addon_configs/7eca76cc_xiaozhi_esp32_server/data/.config.yaml


4.4 点击.config.yaml进入到编辑模式,修改前一定要先关闭最简版然后再修改,否则写入无效!!!


4.5 将服务器秘钥粘贴到“secret”行的后面,注意冒号后面有一个空格!!!


4.6 url行的后面粘贴下面的信息,注意冒号后面有一个空格!!!点击右上角的保存。


http://7eca76cc-xiaozhi-esp32-webui:8002/xiaozhi

[attach]69742[/attach]


4.7 返回最简版加载项界面中点击启动。、


4.8 查看日志


[attach]69745[/attach]


5、小智音响接入


5.1 打开冬瓜大神为咱们准备的小智AI音箱HA专用烧录工具https://xzfw.wghaos.com/网站,选择“Non-OTA”列下的对应的设备型号。


[attach]69743[/attach]


5.2 将小智音箱插到通过数据线插到PC上,点击CONNECT。找到对应的串口。没有显示COM口一个是没安装驱动,另一种可能是这个线没有数据功能。如果不知道那个是小智COM口可以插拔一下来判断。


[attach]69744[/attach]


5.3 弹出点击INSTALL,然后勾选Erase device再点击NEXT,确认后点击INSTALL,等待安装完成。


5.4 重启后语音提示已进入到配网模式,用手机连接到Xiaozhi-XXXX的热点,连接成功后会跳转到小智的wifi连接界面中(没有跳转重新连接一下),输入需要连接的wifi。


5.5 重启后使用唤醒词“你好小智”进行对话,会提示需要输入验证码


5.6 返回智控台,找到智能体管理,点击添加智能体输入任意名称点击确定


[attach]69746[/attach]


5.7 点击设备管理 -> 新增 -> 输入验证码 -> 确定


[attach]69747[/attach]


5.8 点击配置角色确定信息是否都正确,点击保存配置


[attach]69748[/attach]


5.9 使用唤醒功能与小智对话。


6、扩展功能


6.1 进入智控台,选择参数字典 -> 参数管理 -> 第三页 -> Home Assistant设备列表 -> 编辑 这个地方就是HomeAssistant的控制设备列表,我们需要把这个设备安装格式添加进去,即空间,设备名,实体标识符;空间,设备名,实体标识符以此类推,最后以后不需要写分号.。


客厅,玩具灯,switch.cuco_cn_460494544_cp1_on_p_2_1;卧室,台灯,switch.iot_cn_831898993_socn1_on_p_2_1

[attach]69749[/attach]


6.2 实体标识符标识符就是进入你需要控制的设备,找到这个功能的图标 -> 右上角的小齿轮 -> 实体标识符 -> 复制图标,我一般都是新开一个txt文档,然后拼写好再复制到智控台内。


[attach]69750[/attach][attach]69751[/attach]



作者: xiaoff    时间: 2025-5-12 21:30
本帖最后由 xiaoff 于 2025-5-12 21:34 编辑

冬瓜大佬的固件显示不适配,是不是需要重新攒个小智?
作者: kuroko    时间: 2025-5-12 21:40
可以用小黄鱼购买的成品小智对接么。还是只能重新弄一个小智刷这个烧录工具?
作者: 爱捣鼓的哈哥    时间: 2025-5-13 09:41
xiaoff 发表于 2025-5-12 21:30
冬瓜大佬的固件显示不适配,是不是需要重新攒个小智?

不知道耶,我是用的星智1.54没有问题
作者: 爱捣鼓的哈哥    时间: 2025-5-13 09:43
kuroko 发表于 2025-5-12 21:40
可以用小黄鱼购买的成品小智对接么。还是只能重新弄一个小智刷这个烧录工具? ...

在那个专用烧录工具里有的型号都行.
作者: jie1075081704    时间: 2025-5-15 13:41
不能直接试别场景或者设备么,需要每个设备都要单独填么

作者: kenny    时间: 2025-5-15 14:01
大佬,冬瓜大神 那个在线烧录网站是开源的嘛,有没有源码学习学习
作者: 爱捣鼓的哈哥    时间: 2025-5-15 14:20
jie1075081704 发表于 2025-5-15 13:41
不能直接试别场景或者设备么,需要每个设备都要单独填么

目前小智对HA适配还不是特别好,只能一个一个加
作者: 爱捣鼓的哈哥    时间: 2025-5-15 14:20
kenny 发表于 2025-5-15 14:01
大佬,冬瓜大神 那个在线烧录网站是开源的嘛,有没有源码学习学习

这个我就不清楚了,你问问冬瓜大佬!
作者: 222    时间: 4 天前
你好,请问一下,正确的OTA和WS地址在哪里查看,我在那个小智服务器测试页面那里,OTA填写http://homeassistant.local:8002/xiaozhi/ota/,WS写了wss://homeassistant.local:8000/xiaozhi/v1/,也试过换成小智最简化版日志里面给的ws://172.30.33.5:8000/xiaozhi/v1/也不行,




欢迎光临 『瀚思彼岸』» 智能家居技术论坛 (https://bbs.hassbian.com/) Powered by Discuz! X3.5