小智AI源码调试(二):更换自己的服务器后台

前阵子把小智的源码跑起来之后，我把开发环境折腾得差不多了，也试着改了点 UI 和温度采集。可以看这里回顾：小智 AI源码简单调试

但是光跑通官方的服务还不够啊，如果要做产品的话后台必须是自己的才行。所以想要接入自己的大模型、做些个性化功能，肯定得把服务器切到自己的服务上。今天就来写一下怎么把小智的 OTA 地址切换到自己的服务器。（如果是自己改的话应该也会踩不少的坑，这里感谢写服务器的大佬给了很多指点整个过程相对顺利） 这里只介绍如何切换到自己的服务器，不涉及服务器的搭建。

为什么要切自己的服务器

官方默认的 OTA 地址是连接到官方的服务器，如果你想：

• 用自己的大模型（比如 DeepSeek、通义千问等）
• 自定义唤醒词（比如把“你好小智”改成“小艺小艺”）
• 对接自己的业务系统（比如水杯设备的数据上报）
• 不想把设备数据传给官方

那就需要把 OTA 地址改成自己的服务器地址。

整体流程搞清楚

在改代码之前，先把整个流程理清楚，不然改完都不知道发生了什么。

设备启动流程是这样的：

1. 设备上电，先读配置里的 OTA 地址
2. 去请求 OTA 接口，获取 WebSocket 地址
3. 拿着 WebSocket 地址去连接服务
4. 后续的语音识别、大模型回复、语音合成都走这个 WebSocket

关键点： 固件里配置的是 OTA 地址，不是 WebSocket 地址。WebSocket 地址是由 /ota 接口动态返回的。这点一定别搞混。

OTA 返回的数据大概是这样的：

{
  "websocket": {
    "url": "wss://你的服务器/xiaozhi/ws",
    "version": 1
  },
  "smartcup": {
    "wake_name": "小艺小艺",
    "voice_id": "101016"
  }
}

代码修改位置

整个工程的 OTA 地址配置分散在好几个地方，都得改一遍，不然编译的时候可能会被覆盖。

1. 修改 sdkconfig

先找到工程目录下的 sdkconfig 文件，这里面保存了项目的编译配置。

路径是：项目根目录/sdkconfig

文件位置：

CONFIG_OTA_URL="https://api.tenclass.net/xiaozhi/ota/"

改成你自己的 OTA 地址。

注意： 这个文件是自动生成的，每次 idf.py menuconfig 保存后可能会被覆盖，所以最好也改一下下面那个 Kconfig。

2. 修改 Kconfig.projbuild

main/Kconfig.projbuild 这个文件里定义了配置项的默认值，查找 config OTA_URL 这一段，把 default 改成你自己的 OTA 地址。

这个改法比较稳，后面重新生成 sdkconfig 的时候，默认值就是你自己的地址。

3. 修改板型 defaults 文件

如果你用的是特定开发板（比如我手里的 Moji 2.0），工程里可能会有 sdkconfig.defaults.你的板型 这样的文件。

比如我的板子是 movecall-moji2-esp32c5，对应的是 sdkconfig.defaults.movecall-moji2-esp32c5。

检查一下这个文件里有没有 CONFIG_OTA_URL 的定义，如果没有就加上一行：

CONFIG_OTA_URL="https://你的服务器/ota"

为什么要改这么多地方？ 因为项目的构建流程可能会从不同地方读取配置，而且优先级还不一样，多改几处总比漏掉强。

⚠️ 一个重要坑点：NVS 数据会覆盖编译配置

这个坑特意写出来提醒大家。

main/ota.cc 里有段代码是这样的：

cppSettings settings("wifi", false);
std::string url = settings.GetString("ota_url");
if (url.empty()) {
    url = CONFIG_OTA_URL;
}

意思就是：

• 先看 NVS（非易失性存储）里有没有 wifi.ota_url
• 有值就用 NVS 里的
• 没有值才用编译时的 CONFIG_OTA_URL

如果你之前通过配网页面写过 OTA 地址，NVS 里已经存了旧值，那么你改再多源码都没用，它还是走 NVS 里的旧地址。简单说就是之前配网了现在要重新配网覆盖配置

解决方案有两个：

1. 清除 NVS
   ：擦除整个 flash 重新烧录
2. 重新配网
   ：进入配网模式，在高级配置里把 OTA 地址改成新的

我个人倾向第二种，不用擦 flash，比较方便。

AP 配网页面怎么改

如果你的设备已经烧录过，不想重新编译，可以通过 AP 配网页面改：

1. 设备进入配网模式
2. 手机连上设备的热点（一般是 xiaozhi-xxxx 这种名字）
3. 浏览器打开 192.168.4.1
4. 找到 高级配置 或者 Custom OTA URL 这个选项
5. 填入你自己的 OTA 地址
6. 保存，设备自动重启

这种方式改的是 NVS 里的 wifi.ota_url，重启后就会生效。

相关代码在 managed_components/78__esp-wifi-connect/ 这个组件里。

验证切换是否成功

改完烧录之后，怎么确认 OTA 地址切换成功了？

1. 看串口日志

打开串口监视工具（比如 idf.py monitor），设备启动后应该能看到它请求的是你自己的 OTA 地址，而不是官方的 api.tenclass.net。

串口日志如果能搜到你的服务器域名，基本就稳了。

2. 服务端看日志

如果你的服务器能看到设备请求 /ota 的记录，说明设备确实连上了。

重点关注这几个请求头：

• Device-Id
• Client-Id
• User-Agent
• Activation-Version

如果 OTA 请求成功，设备应该会继续请求 /xiaozhi/ws。

3. 命令行验证服务是否正常

可以先用 curl 测一下你的服务是不是可用的：

curl https://你的服务器/health

再测一下 OTA 接口能不能正常返回 WebSocket 地址：

curl -X POST https://你的服务器/ota \
  -H "Content-Type: application/json" \
  -H "Activation-Version: 1" \
  -H "Device-Id: 你的设备ID" \
  -H "Client-Id: test-client-001" \
  -d '{"device":{"device_id":"你的设备ID"}}'

正常返回应该包含 websocket.url 字段。

如果失败了怎么排查

问题 1：服务端看不到 /ota 请求

排查顺序：

• 串口日志里 OTA 地址对不对
• NVS 里有没有旧 wifi.ota_url 在作祟（前面提到的坑点）
• 编译时 CONFIG_OTA_URL 有没有改成功
• 设备 Wi-Fi 连上了吗
• 设备能 ping 通你的服务器吗（DNS 解析）
• HTTPS 证书校验有没有问题（自签名证书可能不认）

问题 2：服务端看到 /ota 但没有 /xiaozhi/ws

排查顺序：

• OTA 返回里的 websocket.url 地址对不对
• 设备有没有正确解析返回的 JSON
• WebSocket 请求头是否带了必要字段（Protocol-Version、Device-Id、Client-Id）
• 你的 Nginx 或网关是否支持 WebSocket Upgrade
• 串口日志里有没有 WebSocket 连接失败的具体错误

一点小建议

这次调试下来，有几个感受：

1. 改配置的时候多改几处
   ：除了 sdkconfig，Kconfig.projbuild 和板型 defaults 也要改，不然编译时可能被覆盖。
2. 注意 NVS 坑
   ：如果之前写过配网，NVS 里的旧值会覆盖编译配置，要么擦 flash，要么重新配网。
3. 串口日志是你的好朋友
   ：大部分问题看串口日志都能找到线索，比如 HTTP 请求失败、WebSocket 连接超时等。
4. 先测接口再联设备
   ：用 curl 先把服务接口调通了，再拿设备去联，能减少很多调试时间。

我的服务器目前已经接入了 DeepSeek 大模型和腾讯云 ASR/TTS，语音链路已经跑通了。下一步准备调试一下本地唤醒词的替换，官方默认的唤醒模型是 “Hi Jason”，如果换成 “小艺小艺” 还得适配一下。改好之后再来跟大家分享。

有问题欢迎留言交流～