保姆级教程：小白也能轻松上手 AI 硬件

大家好我是siuser小伟如果你是一个小白又想玩一下硬件的话那我一定推荐你去接触AI 小智。因为他们的生态非常好教程非常详细你也可以跑一个专属于你自己的 AI 硬件。这篇文章专门写给第一次部署小智 Go 后端的人。最后面有视频演示感兴趣的同学可以看看我建议第一遍不要上来就拉源码、配 Go 环境、改依赖。先用作者打好的 Release 版本跑通。能连上设备、能听、能说、能走大模型再回头折腾源码。小智 Go 后端开源地址在这里https://github.com/AnimeAIChat/xiaozhi-server-go原项目已经提供了不同系统的可执行文件。你只想先体验的话下载对应系统版本就行。我这里先按 Windows 来写。先下载两个东西打开 Release 页面https://github.com/AnimeAIChat/xiaozhi-server-go/releasesWindows 电脑直接下载windows-amd64-server.exe然后再把项目里的配置文件下载下来config.yaml注意下载完以后要把config.yaml改名成.config.yaml这个点很容易漏。少了前面那个点程序可能就读不到配置。最后把这两个文件放到同一个文件夹windows-amd64-server.exe.config.yaml到这里程序本体就准备好了。先改本机 IP后端跑在你的电脑上小智硬件要连过来所以配置里不能随便写一个地址。在 Windows 上按Win R输入cmd回车打开命令行。然后输入ipconfig找到你当前 Wi-Fi 或网卡对应的 IPv4 地址。一般长这样192.168.1.23把配置文件里的服务地址改成你的这个 IP。这里别写localhost也别写127.0.0.1。那是电脑自己访问自己小智硬件在局域网里找不到它。配 ASR让小智听懂你说话ASR 就是语音识别。这个后端默认可以用豆包 ASR所以配置里一般保持DoubaoASR接下来去火山引擎控制台创建应用https://console.volcengine.com/speech/app创建应用的时候名字和简介随便写一个能看懂的就行。重点是勾选这两个能力流式语音识别大模型语音合成大模型后面一个给 TTS 用顺手一起开了省得来回点。应用创建完成后会拿到一个APP ID。把它填进.config.yaml里对应的豆包 ASR 配置。然后进入“流式语音识别大模型”复制里面的Access Token也填到配置文件里。这里提醒一句Access Token不要截图发群也不要直接贴到公开文章里。你自己配置文件里填就行。配 TTS让小智开口说话TTS 是语音合成。配置里把 TTS 供应商设成DoubaoTTS还是用刚才火山引擎那个应用。appid和 ASR 用同一个。然后点进“语音合成大模型”找到Cluster IDAccess Token把这两个填进.config.yaml。ASR 和 TTS 都配完以后小智就具备“听”和“说”的基础能力了。配 LLM先用智谱跑通LLM 就是大模型对话。用的是智谱配置项填ChatGLMLLM打开智谱 API Key 页面https://bigmodel.cn/usercenter/proj-mgmt/apikeys新建一个 API Key。名字随便填比如xiaozhi-test创建后复制 API Key填到.config.yaml的 LLM 配置里。第一次部署别急着换一堆模型。先用一个免费或低成本模型跑通流程。等硬件能正常连上、能识别、能回复再考虑换更好的模型。VLLM 也填智谱配置里还有一段 VLLM。ChatGLMVLLM这个地方也填智谱的 API Key和上面 LLM 用同一个就行。如果你只是先跑通不用在这里想太多。启动后端配置保存好以后双击windows-amd64-server.exeWindows 可能会提示“无法验证发布者”。这是因为它不是常见商业软件签名不代表一定有问题。确认你是从项目 Release 页面下载的就点运行。如果弹出防火墙提示选择允许访问。这一步别点错。小智硬件要从局域网访问你的电脑防火墙不放行后面设备可能连不上。启动成功后会弹出一个命令行窗口里面会刷日志。你主要看这几项ASR 初始化成功TTS 初始化成功LLM 初始化成功如果看到 MCP 初始化失败先不用慌。你没有配 MCP 的话这个报错可以先不管。只要 ASR、TTS、LLM 这些关键模块正常第一轮测试就能继续。改小智硬件的 OTA 地址后端跑起来后还要让硬件知道去哪里找服务。小智设备开机时按住BOOT进入配网模式。然后用手机连接设备热点。进入配网页面的高级选项把 OTA 地址改成http://你的电脑IP:8080/api/ota/比如你的电脑 IP 是192.168.1.23那就填http://192.168.1.23:8080/api/ota/这里还有一个很容易忽略的前提小智硬件和你的电脑必须在同一个 Wi-Fi 下最好也在同一个网段。如果电脑连公司内网硬件连手机热点或者电脑挂了奇怪的网络隔离设备就找不到后端。很多人部署失败不是配置错了是网络没通。第一次测试看什么我建议按这个顺序测后端 exe 能不能启动。日志里 ASR、TTS、LLM 有没有初始化成功。小智硬件能不能连到 OTA 地址。说一句话后后端日志有没有收到请求。小智能不能正常回复。不要一上来就同时改模型、改语音、改硬件配置。先让整条链路通。链路通了再慢慢换模型、换音色、调提示词。跑通后的效果配置没问题的话后端日志和小智硬件大概会是下面这个状态。公众号里这里插入演示视频。视频文件用这个media/xiaozhi-go-backend-demo-wechat.mp4本地演示视频xiaozhi-go-backend-demo-wechat.mp4常见坑1. 配置文件名字不对必须是.config.yaml不是config.yaml也不是.config.yaml.txtWindows 默认会隐藏文件扩展名建议打开文件扩展名显示不然很容易改成假名字。2. IP 写错配置里要写电脑在局域网里的 IPv4 地址。不要写localhost。不要写127.0.0.1。不要写一个已经变掉的旧 IP。如果你重连 Wi-Fi电脑 IP 可能会变变了就要重新改配置。3. 防火墙没放行Windows 第一次运行时会弹防火墙提示。要允许访问。如果当时点了拒绝后面可以去 Windows 防火墙里重新放行这个 exe。4. API Key 或 Token 填串了豆包 ASR、豆包 TTS、智谱 LLM 都有自己的字段。不要把智谱 API Key 填到豆包 Access Token 里也不要把 TTS 的 Cluster ID 漏掉。这类问题看日志一般能看出来。5. MCP 初始化失败没配置 MCP 的情况下可以先不管。第一轮部署只看 ASR、TTS、LLM 和硬件连接。等基础链路跑通再回头研究 MCP。这套部署方式最适合第一轮测试。不用编译不用配 Go 环境也不用先理解整个后端代码结构。你只要下载 exe改配置启动然后让硬件连过来。等你确认小智能正常对话再去折腾源码部署、服务器部署、模型替换都会轻松很多。第一次别贪多。先跑起来。能跑起来后面才有优化的意义。