Files
addons/xiaozhi-esp32-webui/DOCS.md
2025-11-06 20:07:43 +08:00

3.6 KiB
Raw Blame History

小智 AI 智控台

本加载项提供小智 ESP32 是智控台的docker服务需配合其它addons一起使用快速体验本地化小智后端服务全功能版的乐趣。

安装方法与次序

  1. 在加载项仓库中另外安装配套的addons

    mariadb在core仓库中HA官方自带

    redis server在冬瓜甄选仓库中

    小智AI server最简安装版在冬瓜甄选仓库中

  2. "Redis Server" 直接启动

    无需任何操作

  3. 配置"MariaDB" 并启动

    1在“Databases”里增加下面内容然后回车

    xiaozhi_esp32_server
    

    2在“Logins”修改数据库密码为root省事可用下面一行直接替换第一行

    - password: root
    

    3在“Rights”最后增加以下内容

    - database: xiaozhi_esp32_server
      username: homeassistant
    

    4保存后启动

  4. "小智 AI 智控台" 本addons直接启动

    因为本文档开始直接默认设置了mariadb的密码为root。redis的服务器直接设置为“冬瓜甄选仓库”中的redis服务器名。所以直接启动就行。

    1自己注册一个管理员并登录

    2进入后点击上方的“参数管理”复制第一行开头为“server.secret”里的“参数值”里的字符串

    3模型配置——配置大语音模型建议豆包

    4模型配置——配置语音合成建议豆包

    5模型配置——配置语音识别建议豆包

    6模型配置——配置意图识别需要控制HA的话选最后一项“Intent_function_call”设置为"默认"

    • 然后点击“修改”,在“函数列表”的最后面,加上以下的字符后,保存。
    ;hass_get_state;hass_set_state
    
  5. 配置 "小智 AI Server最简安装版"

    1先启动一次等默认配置生成然后停止。

    2使用filebrowser等方式修改“小智AI Server最简安装版”的在“addon_configs”目录——“7eca76cc_xiaozhi_esp32_server”目录——“data”目录——编辑“.config.yaml”文件

     url: http://homeassistant.local:8002/xiaozhi
    
    • 把刚才复制的“server.secret”放到最后一行替换掉注意空格要留好。

    3启动“小智 AI Server最简安装版”服务。

  6. 配置"小智 AI 智控台"接口等

    上续操作等,己经能正常启动了。但是智控台中“参数管理”中

    • server.websocket
    ws://homeassistant.local:8000/xiaozhi/v1/
    

    关键己说明,可以直接开始使用,细节配置大家看一下官方的说明

备用的技术参考配置(可忽略)

mysql_host: core-mariadb #MySQL/MariaDB数据库主机地址,查看方式Home Assistant → 设置 → 加载项 → MySQL/MariaDB → 信息 → 宿主名
mysql_port: 3306 #MySQL/MariaDB数据库端口默认: 3306
mysql_database: xiaozhi_esp32_server #要使用的数据库名称
mysql_username: homeassistant #数据库认证用户名 
mysql_password: root #数据库认证密码 
redis_host: 0920e2ff-redis-server #Redis服务器主机地址查看方式Home Assistant → 设置 → 加载项 → Redis Server → 信息 → 宿主名
redis_port: 6379 #Redis服务器端口默认: 6379
timezone: Asia/Shanghai #设置服务器时区

使用说明

  1. 启动后,点击“打开网页界面”,浏览器访问 http://homeassistant.local:8002 进入 Web 管理界面
  2. 首次访问需要注册用户