正在连接信源…

闪猫侠 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-26body 适配 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 服务平台

文档