闪猫侠 AI 桌面人形机器人(Otto 衍生) 复刻全流程
闪猫侠 AI 桌面人形机器人(Otto 衍生) 从采购、打印、组装到装软件、标定和训练的 204 个步骤,附物料表、购买链接与官方出处。
物料表页估算 200–500 元(视渠道与元件质量);立创开源页标复刻成本约 150 元;套件价格未核对。不含 3D 打印机
物料 · 3D 打印部件
| 零件 | 数量 |
|---|---|
| 身体 · Otto_body · PLA /树脂 | 1 |
| 头部 · Otto_head · PLA /树脂 | 1 |
| 腿部 · Otto_leg · PLA /树脂 | 2 |
| 脚部 · Otto_foot · PLA /树脂 | 2 |
物料 · 3D 打印部件
| 零件 | 数量 |
|---|---|
| 身体 · Otto_body · PLA /树脂 | 1 |
| 头部 · Otto_head · PLA /树脂 | 1 |
| 腿部 · Otto_leg · PLA /树脂 | 2 |
| 脚部 · Otto_foot · PLA /树脂 | 2 |
| 版本 · 发布日期 | 功能描述 |
| --- | |
| v1.0 · 2025-4-9 | 初始版本 |
| v1.1 · 2025-4-16 | 增加 head-2828 喇叭带天线 |
| v1.2 · 2025-4-26 | body 适配 2828 喇叭、适配 1 |
| v1.3 · 2025-5-15 | 减小 leg 长度,防止手臂卡线;修改 |
采购
- 学习基本电路概念
了解正负极和电压等简单电路概念。
- 认识基础电子元件
认识电阻、电容和传感器等基础电子元件。
- 使用万用表测量
使用万用表测量电压和连通性。
- 了解 ESP32 开发板
了解 ESP32 开发板的基本结构和引脚定义。
- 了解 Wi-Fi 网络配置
若学习源码,需要了解基本的 Wi-Fi 网络配置知识。
- 理解 API 与网络请求
若学习源码,需要理解 API Key 以及基本的 HTTP 和 WebSocket 请求概念。
- 了解大模型 API 使用方法
若学习源码,需要了解大模型 API 的基本使用方法。
- 准备开发用电脑
准备一台运行 Windows、Mac 或 Linux 的电脑,用于编程和下载程序。
- 准备 USB Type-C 数据线
准备 USB Type-C 数据线,用于连接 ESP32 开发板和电脑。
- 准备万用表
准备万用表,用于测试电路和排查故障。
- 准备材料和制作打印件
用 1-5 天网购材料、制作 PCB,并完成 3D 打印。
- 查看物料清单
确认基本要求后,查看 /docs/bom 物料清单并准备所需材料。
- 购买完整机器人 DIY 套件
完整套件包含所有所需组件,并已完成程序烧录。
- 购买可直接使用的成品
选择成品购买,到手后即可使用。
- 分别采购所需组件
如果希望自行采购,可使用文档提供的参考链接。
- 查看 v1.0 电子组件
通过文档提供的立创开源链接查看电子组件 v1.0。
- 采购 V1.1 电子组件
除淘宝 6mm 高度的 boot 按键外,立创已匹配元件均可一键下单;未匹配部分使用上面的淘宝链接。
- 购买官方 DIY 套件
从官方店铺购买闪猫侠机器人 DIY 套件。
- 查看立创开源组件
通过立创开源页面查看 Otto 机器人电子组件。
- 按 V1.1 采购元件
使用 V1.1 版本;匹配的元件在立创一键下单,未匹配部分使用上面的淘宝链接,boot 按键高度为 6mm。
- 确认机器人总预算
Otto DIY 机器人的总成本预计约为 ¥200–¥500,具体取决于购买渠道和组件质量。
- 获取 Otto 硬件设计
打开文档链接的立创开源硬件项目,获取 Otto 机器人硬件设计。
打印与加工
- 了解 3D 打印原理
了解 3D 打印的基本原理。
- 下载并处理 STL 文件
如果打算自己打印外壳,需要会下载和处理 STL 文件。
- 使用嘉立创 3D 打印
文档推荐使用嘉立创 3D 打印。
- 喷漆或涂色打印件
可按自己的喜好为打印件喷漆或涂色。
- 打开 PCB 下单教程
转到 PCB 下单教程,按照教程订购 V1.1 PCB。
- 下载打印模型
点击下载打印模型,获取全部 STL/CAD 文件。
- 选择部件版本和数量
3MF 文件不完整,下载并打印最新版 STL/CAD 文件。body 分为有手臂和无手臂两个版本;手臂和腿都使用 leg,有手臂版本打印 leg 4 个和 grip 2 个,无手臂版本打印 leg 2 个。
- 按照 PCB 下单教程下单
转到文档中的 PCB 下单教程进行下单。
- 下载 3D 打印模型
从 MakerWorld 下载 STL/CAD 打印模型。
- 打印最新版机身和零件
打印最新版;带手臂版本打印 4 个 leg 和 2 个 grip,不带手臂版本打印 2 个 leg。
组装
- 准备全部零部件
参照零部件清单,准备好组装所需的全部零部件。
- 准备组装工具
准备斜口钳和 M2 螺丝刀。
- 清理工作台
开始组装前,准备一个干净的工作台。
- 检查打印件
检查所有 3D 打印件是否完整。
- 清除支撑材料
清理 3D 打印件上的支撑材料。
- 疏通所有孔位
确保所有打印件上的孔位通畅。
- 安装腿部舵机
安装两侧舵机:双排三针的外侧接棕色舵机线(负极),采用上腿下足的连接方式。
- 暂时拆下舵机线
拆下舵机线,等身体安装完成后再重新插上。
- 固定腿部舵机
使用舵机包内的两个大螺丝固定舵机。
- 修剪十字摇臂
修剪舵机十字摇臂,将较长的两端各剪掉大约一半。
- 安装十字摇臂
将修剪后的十字摇臂安装到腿部。
- 摆正腿部方向
让腿部圆柱突起朝向屏幕一侧,腿部垂直朝前;尽量避免内八或外八,轻微角度不影响。
- 固定腿部并拧紧
固定腿部,并拧紧固定螺丝。
- 安装脚部舵机摇臂
将图示形状的摇臂垂直朝上安装,并拧紧螺丝。
- 固定脚部
将脚部固定到位。
- 穿入脚部舵机线
将脚部舵机线穿过身体内部。
- 安装脚部
把脚部安装到机器人上。
- 安装脚部舵机固定螺丝
安装用于固定脚部舵机的螺丝。
- 固定喇叭
固定喇叭,并使用其带线的开槽。
- 安装内部组件
安装舵机线、喇叭、电池和天线。
- 安装主板
将主板安装到位。
- 检查外部控件安装
确保屏幕、Type-C充电口和开关均已正确安装到位。
- 安装脑袋上盖
安装脑袋上盖;上盖前侧的突起用于压紧电路板。
- 小心操作组件
组装时小心操作,避免损坏零部件。
- 适度拧紧螺丝
确保所有螺丝拧紧,但不要过度用力。
- 确认舵机方向
安装舵机时注意其安装方向。
- 准备十字螺丝刀
准备螺丝刀套装,使用小型十字螺丝刀进行组装。
- 准备剪线与剥线钳
准备剪线钳和剥线钳,用于处理线材和接线。
- 准备焊接工具
如果自行焊接电路板,准备烙铁套装,并配备风枪或加热台。
- 具备动手组装能力
能够按照指示组装电子元件和机械部分。
- 焊接机器人电路板
可选地用 2-4 小时完成电路板焊接。
- 组装机器人硬件
用 1-2 小时组装机器人的硬件。
- 根据视频教程组装套件
根据视频教程自行组装,组装时间约为40分钟。
软件与固件
- 准备开发环境与硬件
准备 VS Code 或 Cursor、Espressif 官方 ESP-IDF 扩展、ESP-IDF v6.0.2、Git、可传输数据的 USB Type-C 线,以及已安装电池的 Otto Robot 主板。项目主线建议使用 v6.0 或以上稳定版本,首选 v6.0.2。
- 下载源码并打开项目
克隆 xiaozhi-esp32 仓库,进入仓库目录,然后使用编辑器打开该目录。
- 安装工具链并核对版本
首次使用 ESP-IDF 扩展时,按照扩展提示完成工具链安装。确认编辑器底部显示 ESP-IDF v6.0.2。
- 选择 ESP32-S3 目标芯片
点击编辑器底部状态栏中的目标芯片名称,在弹出的芯片列表中选择 `esp32s3`。
- 等待配置并打开 menuconfig
第一次配置项目时,ESP-IDF 会下载依赖并生成构建文件,首次等待时间可能较长。配置完成后,点击底部齿轮按钮打开 SDK 配置编辑器(menuconfig)。
- 查找 Target Board 配置
在 SDK 配置编辑器中展开 **Xiaozhi Assistant**,找到 **Target Board** 配置项。
- 选择 Otto Robot 开发板
打开开发板列表并选择 **Otto Robot**。如果列表中没有该选项,确认第 1 步选择的目标芯片为 `esp32s3`。
- 启用 WebSocket 服务
在 SDK 配置编辑器顶部搜索 `websocket`,勾选 **Component config → HTTP Server → WebSocket server support**;某些源码版本会自动启用,已经勾选时无需修改。
- 保存 SDK 配置
点击右上角的 **保存**,等待配置写入完成。
- 编译 Otto Robot 固件
点击编辑器底部的 **生成(Build)** 按钮;首次构建需要联网下载组件,因此会比后续构建耗时更长。产物位于 `build/`,烧录时 ESP-IDF 会写入引导程序、分区表、主程序和资源文件,不要只烧录 `xiaozhi.bin`;如需可分发的合并固件,请参阅程序烧录页面的合并固件命令。
- 连接设备并选择串口
确认电池已安装,使用 USB Type-C 数据线连接 Otto Robot 和电脑,然后从 ESP-IDF 扩展中选择新出现的串口。普通版与摄像头版使用同一个固件;摄像头版应在开机前连接摄像头,首次烧录或无法自动进入下载模式时,应按住 **BOOT** 再打开电源并重新尝试烧录。
- 烧录固件并查看日志
点击编辑器底部的 **烧录(Flash)** 按钮,出现烧录方式选择时选择 **UART**,等待终端显示烧录完成。排查启动问题时,可打开 ESP-IDF 串口监视器查看日志。
- 重新烧录官方固件
若只是想恢复官方固件,可返回程序烧录页面重新烧录最新版本。
- 运行硬件版本自动识别
启动固件;固件将 GPIO15、GPIO16 配置为输入并启用内部弱下拉,连续采样均为高时选择 CAM 板配置,否则使用无摄像头板配置。
- 运行摄像头自动识别
- 配置小智后台角色
将角色设为拥有四个舵机控制肢体的可爱双足机器人,并配置基础移动、特殊动作和手部动作;手部动作仅在配置手部舵机后可用。
- 使用局域网 WebSocket
Otto 内置 WebSocket 服务器,可在局域网内直接调试,无需经过云端。连接 `ws://<设备IP>:8080/ws`。
- 获取 Otto 的 IP 地址
确认 Otto 已连接 WiFi,并通过小程序或串口日志获取 IP 地址。
- 打开 WebSocket 调试工具
打开任意 WebSocket 调试工具,如 websocket.org/echo 或浏览器控制台。
- 连接 Otto
连接 `ws://192.168.x.x:8080/ws`,末尾必须有 `/ws`。
- 发送 JSON 命令
发送 JSON 命令,响应会直接返回到同一连接。
- 初始化协议
首次连接时初始化 JSON-RPC 2.0 协议,协议版本为 `2024-11-05`,并使用递增的 `id`。
- 获取工具列表
使用空的 `params` 对象和递增的 JSON-RPC `id` 请求可用工具。
- 打开小智后台
使用浏览器访问 xiaozhi.me,进入小智后台。
- 注册并登录账户
在小智后台注册账户,然后登录。
- 添加并绑定设备
按照页面提示添加机器人设备并完成绑定。
- 设置机器人角色
为机器人设置角色,例如填写机器人介绍。
- 选择大模型类型
在后台选择机器人大模型类型。
- 选择语音角色声音
在后台选择语音角色的声音。
- 粘贴示例角色设定
复制并粘贴文档给出的 OttoRobot 示例角色设定,其中列出动作 1 至 16,并要求每次说话前先根据心情随机发送一个动作指令。
- 烧录所需版本固件
使用微信小程序控制前,为机器人烧录 otto2.0.4-2 以上版本的固件。
- 下载涂鸦应用
在应用商城下载《涂鸦》APP。
- 熟悉 ESP32 开发环境
熟悉 ESP-IDF 开发框架或 Arduino ESP32 环境。
- 编译并上传 ESP32 程序
能够将程序编译并上传到 ESP32 开发板。
- 准备 ESP-IDF 开发环境
可选用 ESP32 官方的 ESP-IDF 开发环境。
- 了解 C/C++ 编程
可选地具备理解和修改 C/C++ 代码的基本编程知识。
- 安装开发环境
可选地用 1-2 小时安装开发环境。
- 烧录固件并进行配置
用 0-1 小时烧录固件并完成配置。
标定与测试
- 打开机器人电源
每次进入新的 Wi-Fi 网络环境时,都需要为 OttoRobot 重新配置网络。先打开机器人电源。
- 等待机器人创建热点
等待机器人创建名称为 `xiaozhi-XXXX` 的热点。
- 连接机器人热点
使用手机连接 `xiaozhi-XXXX` 热点,无需输入密码。
- 输入家庭 Wi-Fi 信息
连接热点后,自动进入网页。输入家庭 Wi-Fi 的名称和密码,然后提交以完成配网。
- 打开小智后台
打开浏览器并访问 `xiaozhi.me`。
- 注册并登录账户
注册小智账户,并登录该账户。
- 添加并绑定机器人
在后台中添加机器人设备,并按照页面提示完成绑定。
- 配置后台功能
可在后台配置角色设定、大模型类型和语音角色声音。
- 重启机器人设备
完成后台配置后,重启机器人设备。
- 设置 OttoRobot 示例角色
将本节的示例身份、动作能力和个性特点复制并粘贴到角色设定中;其中手部动作仅在配置手部舵机时可用。
- 选择动作速度和幅度
低速使用 speed = 1200-1500,中速使用 900-1200,高速使用 500-800。小幅度使用 amount = 10-30,中幅度使用 30-60,大幅度使用 60-120。
- 设置动作执行次数
通过 steps 设置动作执行的步数或次数;数值越大,动作持续时间越长。
- 设置动作速度
speed 的范围为 500-1500,数值越小,动作执行得越快。
- 设置动作方向
移动动作中,direction = 1 表示向左或向前,direction = -1 表示向右或向后。手部动作中,1 表示左手,-1 表示右手,0 表示双手。
- 设置动作幅度
amount 或 arm_swing 的范围为 0-170 度,数值越大,动作幅度越大。arm_swing 为 0 时表示不摆动。
- 配置手部舵机
配置手部舵机后,才能使用文档中标记 \* 的手部动作。
- 排查 Wi-Fi 连接
检查 Wi-Fi 名称和密码是否正确,确保 Wi-Fi 信号强度足够,并尝试重启机器人。
- 排查语音识别失败
确保环境噪音较小,提高说话音量,并检查唤醒词是否正确。
- 排查动作执行异常
检查电量是否充足,确保机器人处于稳定状态,并尝试重启机器人。
- 设置 Otto 动作参数
- 设置必填的动作名称
将 action 设置为支持的动作列表中的动作名称。
- 设置执行步数
将 steps 设置为 1-100,默认值为 3;数值越大,动作持续时间越长。
- 设置动作速度
将 speed 设置为 100-3000,默认值为 700;数值越小越快。大多数动作为 500-1500 毫秒,旋风腿为 100-1000,起飞为 200-600。
- 设置动作方向
将 direction 设置为 -1、0 或 1,默认值为 1。walk 和 turn 中,1 表示前进或左转,-1 表示后退或右转;bend、shake_leg 和 moonwalk 中,1 表示左,-1 表示右。
- 设置动作幅度
将 amount 设置为 0-170,默认值为 30;数值越大,动作幅度越大。
- 设置手臂摆动幅度
将 arm_swing 设置为 0-170,默认值为 50;仅用于 walk 和 turn,0 表示不摆动手臂。
- 读取舵机微调值
调用 `self.otto.get_trims`,不传参数,以获取舵机微调值。
- 设置单个舵机微调
调用 `self.otto.set_trim` 可永久保存单个舵机微调。`servo_type` 可选 `left_leg`、`right_leg`、`left_foot`、`right_foot`、`left_hand`、`right_hand`;`trim_value` 范围为 `-50` 到 `50`。
- 获取机器人 IP 地址
向机器人询问其 IP 地址。
- 输入 IP 并配置控制
在微信小程序中输入机器人 IP 地址,然后进行控制、校准和自定义动作。手机与机器人必须处于同一个网络环境。
- 为新网络重新配网
每次进入新的 Wi-Fi 网络环境,都要为 OttoRobot 重新配置网络。
- 启动蓝牙配网
打开机器人电源,等待它自动进入蓝牙配网并播报“我已经进入配网状态”。
- 添加涂鸦设备
手机连接 2.4G Wi-Fi 并打开蓝牙,然后在涂鸦 App 右上角发现并添加设备。进入 App 界面后,可以通过语音或 App 控制机器人。
- 排查 Otto Robot 未识别问题
确认目标芯片是 `esp32s3`,然后关闭并重新打开 SDK 配置编辑器。
- 排查组件下载停滞问题
首次构建需要联网下载依赖;检查网络后重试,并确认 ESP-IDF 扩展使用的是 v6.0 或以上的稳定版本。
- 排查串口未识别问题
换用确认支持数据传输的 USB 线和 USB 接口;首次烧录时按住 **BOOT** 再打开电源,Windows 用户还需要确认串口驱动已正确安装。
- 检查排线并重新启动
先断电,检查摄像头和其他排线是否插好,再重新上电并查看串口日志。
- 初始化舵机位置
打开开关,使舵机初始化到 90 度;安装过程中确保舵机齿轮不发生变化,手臂初始为向下 45 度。
- 排查舵机不转动
重新启动机器人,检查接线是否正确,确认电源供应正常,并验证程序是否已正确烧录。
- 修复结构不稳定
检查螺丝是否拧紧,并确认3D打印件是否变形。
采数据与训练
- 向前走三步
以速度 700、方向 1 执行 `walk` 动作,共 3 步。
- 举起双手
举手动作需要手部舵机。
用起来
- 使用微信小程序控制 Otto
扫描上方二维码,使用微信小程序控制 Otto 机器人。
- 调用 Otto 动作工具
所有动作都通过统一的 self.otto.action 工具调用,并使用 action 参数指定动作名称。
- 执行行走动作
使用 walk 行走,并提供 steps、speed、direction 和 arm_swing。
- 执行转身动作
使用 turn 转身,并提供 steps、speed、direction 和 arm_swing。
- 执行跳跃动作
使用 jump 跳跃,并提供 steps 和 speed。
- 执行左右摇摆动作
使用 swing 左右摇摆,并提供 steps、speed 和 amount。
- 执行太空步动作
使用 moonwalk 执行太空步,并提供 steps、speed、direction 和 amount。
- 执行弯腰动作
使用 bend 弯曲身体,并提供 steps、speed 和 direction。
- 执行摇腿动作
使用 shake_leg 摇腿,并提供 steps、speed 和 direction。
- 执行上下运动
使用 updown 上下运动,并提供 steps、speed 和 amount。
- 执行旋风腿动作
使用 whirlwind_leg 执行旋风腿,并提供 steps、speed 和 amount。
- 执行坐下动作
使用 sit 坐下,无需参数。
- 执行展示动作
使用 showcase 串联执行多个动作,无需参数。
- 将 Otto 复位到初始位置
使用 home 将机器人复位到初始位置,无需参数,调用内容为 {"action": "home"}。
- 执行举手动作
使用 hands_up 举手,并提供 speed 和 direction;此动作需要手部舵机。
- 执行放手动作
使用 hands_down 放手,并提供 speed 和 direction;此动作需要手部舵机。
- 执行挥手动作
使用 hand_wave 挥手,并提供 direction;此动作需要手部舵机。
- 执行大风车动作
使用 windmill 执行大风车,并提供 steps、speed 和 amount;此动作需要手部舵机。
- 执行起飞动作
使用 takeoff 执行起飞,并提供 steps、speed 和 amount;此动作需要手部舵机。
- 执行健身动作
使用 fitness 执行健身动作,并提供 steps、speed 和 amount;此动作需要手部舵机。
- 执行打招呼动作
使用 greeting 打招呼,并提供 direction 和 steps;此动作需要手部舵机。
- 执行害羞动作
使用 shy 执行害羞动作,并提供 direction 和 steps;此动作需要手部舵机。
- 执行广播体操
使用 radio_calisthenics 执行广播体操,无需参数,但需要手部舵机。
- 执行爱的魔力转圈圈
使用 magic_circle 执行爱的魔力转圈圈,无需参数,但需要手部舵机。
- 检查手部舵机配置
标记 * 的手部动作仅在配置了手部舵机时可用。
- 尝试奥托语音指令
使用命令让机器人行走、转向、跳跃、跳舞、坐下、挥手、举手、做健身动作和停止。
- 动作中继续接收指令
小智为机器人动作创建新的后台任务,动作执行期间仍可接受新的语音指令。说“停止”可立即停下 Otto。
- 挥手
使用手部舵机让机器人挥手。
- 立即停止所有动作
立即停止机器人的所有动作。
- 获取运动状态
获取机器人运动状态,返回 "moving" 或 "idle"。
- 获取 IP 地址
获取机器人的 IP 地址。
- 获取电池电量
获取机器人的电池电量。
- 获取设备状态
获取音量、网络、电池等设备状态信息。
- 设置音量
将扬声器音量设置为 0 到 100 之间的值。
- 重启设备
重启设备。
- 普通移动模式
逐步移动舵机:先将 ll 设为 110、rl 设为 70,速度为 800;再将二者设为 90,速度为 800。
- 双臂摆动振荡器模式
以 lh 和 rh 振幅 30、两者中心 90、右手相位 180、周期 500、次数 5.0 摆动双臂。
- 左右摇摆波浪振荡器模式
以 ll 和 rl 振幅 20、两者中心 90、右臂相位 180、周期 600、次数 5.0 进行左右摇摆波浪。
- 接通机器人电源
机器人电源与充电口位于身体下方。电量显示可能不够精准,应及时充电以避免意外断电。
- 使用唤醒词唤醒机器人
对着机器人说出“你好小智”,即可将它唤醒。
物料
- ESP32‑S3‑WROOM‑N16R8(推荐乐鑫官方模组)
- SG90 9g 舵机 6 个(推荐金属齿轮,可多备一个)
- 1.54 寸 240×240 LCD、MAX98357A 功放与 2828 4Ω 3W 喇叭、ICS‑43434 麦克风(或 INMP441)
- 103450 2000 mAh 锂电(V1.1 可用 18650 2200 mAh)
- 立创下单的主板 PCB 与 3D 打印 body、head、leg ×2、foot ×2(PLA/树脂)
工具
- 3D 打印机
- 电烙铁(项目页有焊接指南)
- 可传数据的 USB‑C 线
技能
- 贴片焊接
- 网页在线烧录,或 ESP‑IDF v6.0.2 编译 Otto Robot 板型
- 小智后台角色与 MCP 服务配置
软件
- txp666/xiaozhi-esp32 固件(Otto Robot 板型)
- xiaozhi.me 后台与闪猫 MCP 服务平台