一、操作场景
·小智 AI 服务端基于小智通信协议，为开源智能硬件项目 xiaozhi-esp32提供后端技术支撑。该服务端支持 AI 推理服务与 API 应用的快速部署，可为 xiaozhi-esp32硬件项目提供稳定可靠的运行保障，确保其全链路高效顺畅运作。
·该应用模板预置了 xiaozhi-esp32-server，基于 Ubuntu 24.04 LTS 64bit 操作系统构建。
二、创建小智 AI 服务端实例
·应用创建方式：选择为使用应用模板 > 小智 AI 服务端，建议购买内存配置 4GB 及以上，其他参数可参见 购买方式 进行配置。
注意：说明：
·地域：建议优先选择小智 AI 服务端使用者当前所在地或网络环境最优的区域，以降低网络延迟、提升本地访问速度。
·可用区：默认勾选随机分配，也可自行选择可用区。
·实例套餐：产品组合售卖方式（包含套餐类型、套餐规格），不同套餐包含不同规格 CPU、内存、SSD 云硬盘、带宽或峰值带宽、流量包的组合。详情请参见 基础套餐。
·服务器名称：自定义实例名称，若不填则默认使用镜像名称-四位随机字符。批量创建实例时，连续命名后缀数字自动升序。例如，填入名称为 LH，数量选择3，则创建的3个实例名称为 LH1、LH2、LH3。
·登录方式：你可通过该项设置实例的登录方式。
·密码登录：
·自动生成密码：自动生成的密码将会以站内信方式发送。
·自定义密码：自定义设置实例的登录密码。
·SSH 密钥：为 Linux 实例绑定 SSH 密钥。
·扫码登录：设置后支持通过微信扫码免密码登录 Linux 实例。
·自动续费：按照实际需求配置即可。
·共享存储：你可以选择实例创建过程中购买共享存储超值资源包，将自动挂载默认对象存储桶，详情请参见 介绍。注意事项如下：
·2023年10月17日之后购买的实例，可以选择是否购买共享存储超值资源包，之前购买的实例可在 对象存储控制台 购买套餐包。
·当前地域下已有生效共享存储超值资源包，后续购买实例时你可直接选择一键挂载存储桶，不会再提供共享存储超值资源包。
·目前仅应用模板和操作系统镜像中的 Linux 镜像支持共享存储。
·时长：表示轻量应用服务器的使用时长。
注意：说明:
注意：你可勾选账户余额足够时，实例到期后按月自动续费，开启实例自动续费功能。当实例创建成功后，可参见 自动续费 修改已有的自动续费设置。
·台数：表示需购买轻量应用服务器的数量。
3. 单击立即购买，并根据页面提示提交订单完成支付。
4. 返回轻量应用服务器控制台。
5. 待实例创建完成后，单击实例卡片，进入该实例的详情页，即可进行后续操作。
三、配置小智 AI 服务端
1. 选择应用管理页签，单击访问智控台地址 (端口8002已默认放通)。
2. 单击新用户注册，进入注册页面，输入用户信息后单击立即注册。
3. 注册成功后，页面会自动跳转至登录界面，输入刚刚注册的用户名和密码，输入验证码，单击登录。
4. 在顶部菜单栏选择参数字典 > 参数管理，在列表中找到参数编码 server.secret，复制参数值。
5. 返回轻量应用服务器控制台，登录目标服务器实例。详细登录步骤你可以参见 使用 OrcaTerm 登录 Linux 实例。
6. 单击左上角，进入 OrcaTerm 文件管理器，在文件路径搜索框内输入/home/lighthouse/xiaozhi-server/data，单击进入。
注意：说明：
注意：这篇档使用 OrcaTerm 进行操作，你也可以选择其他方式登录终端。
7. 单击右上角，显示隐藏文件，找到.config.yaml。单击文件名打开文件。
8. 将.config.yaml中的 secret 修改为 步骤4 中复制的参数值，将 URL 改为 http://xiaozhi-esp32-server-web:8002/xiaozhi。
9. 登录智控台，在顶部菜单栏单击模型配置，在左侧选择大语言模型，在智谱 AI 右侧单击修改， 将 API 密钥改为你自己注册的智谱 AI 密钥，单击保存。
注意：说明：
10. 在服务器终端/命令行中输入并执行以下命令，用于重启 xiaozhi-esp32-server 并查看容器日志。
docker restart xiaozhi-esp32-serverdocker logs -f xiaozhi-esp32-server
当输出以下格式信息时，表示 Server 启动成功。
25-02-23 12:01:09[core.websocket_server] – INFO – Websocket地址是 ws://xxx.xx.xx.xx:8000/xiaozhi/v1/25-02-23 12:01:09[core.websocket_server] – INFO – =======上面的地址是websocket协议地址，请勿用浏览器访问=======25-02-23 12:01:09[core.websocket_server] – INFO – 如想测试websocket请用谷歌浏览器打开test目录下的test_page.html25-02-23 12:01:09[core.websocket_server] – INFO – =======================================================
11. 在服务器页面中，选择并进入服务器实例详情页。
12. 选择防火墙页签，单击添加规则后放通8000端口。如下：
13. 登录智控台，在顶部菜单栏单击参数字典 > 参数管理，在参数编码 server.websocket 的右侧单击编辑，将参数值修改为ws://实例公网 IP:8000/xiaozhi/v1/，单击保存。
14. 在参数编码 server.ota 的右侧单击编辑，将参数值修改为http://实例公网IP:8002/xiaozhi/ota/，单击保存。
15. 访问 小智 AI GitHub 仓库，单击 libopus.js 和 index.html，将这两个文件下载到本地，并放到同一路径下。
16. 本地打开 test_page.html，在第一个文本框中输入 步骤14 中的 OTA 地址，在第二个文本框中输入 步骤13 中的 WebSocket 地址，单击连接。
连接正常，则说明你已成功配置小智 AI 服务端，接下来，你可以开始操作你的 esp32 设备。你可以 自行编译 esp32固件 或 配置使用编译好的固件。