X XiaoO AI

小智 AI 设备接入

小智 AI 设备接入 XiaoO AI

XiaoO AI 兼容小智 AI WebSocket 报文协议。已有小智生态设备进入配网模式后,修改 OTA Endpoint,即可获取激活码并在网页端绑定设备。

OTA Endpoint 配置地址

在小智 AI 设备配网模式中,将 OTA Endpoint 设置为:

https://api.xiao-o.cn/api/v1/ota

设备请求成功后,会通过 OTA 接口返回激活码。登录 XiaoO AI 网页端后,在“智能体管理”中点击“激活”,输入设备显示或播报的激活码即可完成绑定。

三步完成设备绑定

  1. 让小智 AI 设备进入配网模式。
  2. 将 OTA Endpoint 改为 https://api.xiao-o.cn/api/v1/ota
  3. 设备获取激活码后,登录 XiaoO AI 网页端,在“智能体管理”中点击“激活”并输入激活码。

接入后可以使用哪些能力

设备级智能体配置

为每台设备独立配置助理名称、角色设定、声音、大模型服务、欢迎语和知识库绑定。

开放模型与工具接入

通过第三方大模型配置、MCP 服务器和业务接口,把设备对话连接到现有服务能力。

对话与运维管理

在网页端查看设备状态、OTA 开关、对话历史和配置验证结果,便于排查接入问题。

兼容边界

常见问题

设备没有返回激活码怎么办?

请确认设备已进入配网模式,OTA Endpoint 填写完整且网络可访问。仍无法获取时,可查看开放 API 文档中的 OTA 请求格式。

接入后配置什么时候生效?

通常新会话会使用最新配置。如果正在进行的会话没有立即变化,可以断开后重新连接,或重新开始一次对话。