Open Source · Fullstack DIY · Otto DIY

闪猫1号AI桌面人形机器人_

语音版 · 本页 OttoClaw 静默版 →

入门 AI、智能硬件、AI 桌面机器人与具身智能的必备 DIY 套件。软硬件全栈开源,小白约 30 分钟即可完成组装;外壳 3D 模型、固件代码、兼容服务端代码与硬件扩展全面开放。

AI大模型具身智能AI 硬件开源生态科创教育
30MIN组装 Assembly
22动作原语 Motions
100%全栈开源 Open
闪猫1号 AI桌面人形机器人
[ KIT ] — 套件概览

一台机器人,
一整套 AI 硬件课Essential DIY kit for AI & embodied intelligence.

从麦克风到舵机,闪猫1号把 AI 桌面机器人的核心模块装进一块 ESP32-S3 主板。动手组装一次,就摸清了智能硬件的完整链路。

Hardware Modules · 硬件模块
M/01麦克风ICS-43434 / INMP441
M/02扬声器2828 · MAX98357A
M/031.54″ 显示屏240 × 240 LCD
M/046 路舵机SG90 / SG90s × 6
M/05触摸 IOTouch Input
M/06WiFi + 蓝牙ESP32-S3-WROOM-N16R8
M/07表情系统LCD Eyes
M/08动作系统22 Motion Primitives
Open Ecosystem · 开放生态
01

外壳 3D 模型

开源 STL 文件,可在 MakerWorld 下载并自行打印、改造造型

02

固件代码

基于 xiaozhi-esp32 与 OttoDIYLib,GitHub 开源,可二次开发

03

兼容服务端代码

兼容小智 AI、涂鸦智能、闪猫侠 AI 等服务后端

04

硬件扩展

立创开源 PCB 工程,元件清单透明,可一键下单与扩展

[ BUILD ] — 30 分钟组装

从一盒零件,到一个会看向你的伙伴

不需要电子基础,不需要编程经验。跟着图文教程一步步来,30 分钟后,它会在桌上第一次对你眨眼。

Build Log

四步,从零件到整机

开箱清点 → 装舵机拼四肢 → 上螺丝装电池 → 开机联网激活,一把螺丝刀就够。

30min
  1. 开箱开发板、舵机、螺丝、电池与 3D 打印外壳,逐件清点,对照清单确认齐全。
  2. 组装装舵机、拼四肢、上螺丝、装电池,一把螺丝刀就够——从零件到一台完整的机器人。
  3. 开机联网激活通电配对 WiFi,完成激活即可使用:语音交互、视觉感知、动作交互,第一次眨眼。
  4. 二次开发改外形——四足机械狗、云台机器人、你的专属造型;加功能——办公助手、个人助理、跳舞机器人。
[ CO-CREATE ] — 社区共创

社区共创 · 成就墙Open source is creativity, not just code.

开源不只是代码,更是创造力。看看社区创客们用闪猫1号做出的惊艳二次创作 — 每一个都是独一无二的。

10K+Creators
∞Possible
100%Open
Your creation matters

你的创意就是下一个成就。加入闪猫侠开源社区,分享你的二次创作,让更多人看到你的作品!

[ 01 ] — Intro

闪猫1号 AI桌面人形机器人Product Overview · 产品介绍

同一硬件 · 两套系统

闪猫1号现在有两套并列的软件系统 — 语音版(本页) 和 OttoClaw。硬件完全相同,软件架构完全不同。

Voice · 你在这里语音版语音对话 · e 人首选 · 云端+本地
Silent · OttoClaw →OttoClaw钉钉消息 · i 人首选 · 纯本地 ESP32-S3 · 全栈开源

闪猫1号是一个开源的可自行制作的 AI 桌面人形机器人,灵感源于 2016 年 Camilo Parra Palacio 创建的 Otto DIY 项目。闪猫侠研发团队自研端侧算法、外观设计、机械结构,结合 3D 打印与通用电子元件,让小白用户仅需 30 分钟、超低成本即可手搓专属桌面 AI 机器人。

通过云端一体架构,闪猫1号具备 AI 语音对话、AI 动作反馈、AI 视觉系统等能力,深度融合情感陪伴、创客教育、3D 打印、AI 大模型、具身智能、智能家居等多元场景,并支持一键接入闪猫侠 AI、小智 AI、涂鸦智能、火山引擎等主流 AI 服务,是 AI 桌面机器人的智能生态硬件平台。

1.1核心能力一览

闪猫1号同时兼容三套 AI 服务后端,共享以下核心能力,不同后端各有独家亮点:

能力小智 AI涂鸦智能闪猫侠 AI(内测)
联网方式Wi-Fi + ML307 Cat.1 4GWi-Fi + ML307 Cat.1 4GWi-Fi + ML307 Cat.1 4G
唤醒交互语音 / BOOT键唤醒打断语音 / BOOT键唤醒打断语音 / BOOT键唤醒打断
离线唤醒ESP-SR 技术ESP-SR 技术ESP-SR 技术
语音对话WebSocket / UDP 流式WebSocket / UDP 流式WebSocket / UDP 流式
语言识别5种(国粤英日韩)5种(国粤英日韩)10种+(含俄/西/阿/越/意/乌等)
声纹识别3D Speaker3D Speaker3D Speaker
语音合成火山引擎 / CosyVoice TTS火山引擎 / CosyVoice TTS火山引擎 / CosyVoice 等 TTS
AI大模型Qwen / DeepSeek / DoubaoQwen / DeepSeek / DoubaoSuperCat LLM2 + Qwen / DeepSeek / Doubao / 文心一言
记忆短期记忆短期记忆短期 + 长期记忆(可选)
独家亮点—涂鸦全生态智能家居语音控制更多语言 + 更多大模型 + 长期记忆

1.2预定义动作(22 个动作原语)

每个动作完成后自动归位(home),随时接收新指令。所有动作均可通过语音指令或 MCP 工具调用:

#类别动作名称MCP 工具参数说明
01基础移动行走otto.walk_forwardsteps / speed / direction / arm_swing向前或向后行走指定步数
02基础移动转向otto.turn_leftsteps / speed / direction / arm_swing原地左转或右转
03基础移动跳跃otto.jumpsteps / speed双脚同时跳跃
04特殊动作摇摆otto.swingsteps / speed / amount身体左右摇摆
05特殊动作太空步otto.moonwalksteps / speed / direction / amount经典太空步滑行
06特殊动作弯曲otto.bendsteps / speed / direction身体前后弯曲
07特殊动作摇腿otto.shake_legsteps / speed / direction单腿或双腿摇摆
08特殊动作上下otto.updownsteps / speed / amount身体上下起伏运动
09特殊动作旋风腿otto.whirlwind_legsteps / speed / amplitude快速旋转踢腿动作
10手部动作 *举手otto.hands_upspeed / direction单手或双手举起
11手部动作 *放手otto.hands_downspeed / direction单手或双手放下
12手部动作 *挥手otto.hand_wavedirection单手挥手打招呼
13手部动作 *大风车otto.windmillsteps / speed / amplitude双臂做大风车旋转
14手部动作 *起飞otto.takeoffsteps / speed / amplitude双臂向上展开如起飞
15手部动作 *健身otto.fitnesssteps / speed / amplitude双臂做健身举举动作
16手部动作 *打招呼otto.greetingdirection / steps举手打招呼互动
17手部动作 *害羞otto.shydirection / steps双手遮脸害羞动作
18手部动作 *广播体操otto.radio_calisthenics无完整广播体操动作序列
19手部动作 *爱的魔力转圈圈otto.magic_circle无双臂旋转的趣味动作
20系统动作坐下otto.sit无机器人坐下姿态
21系统动作展示otto.showcase无展示一系列预设动作
22系统动作复位otto.home无所有舵机回到初始位置

* 手部动作(#10–19)仅在配置手部舵机时可用。另有两个高级工具:otto.stop(停止所有动作)、otto.servo_sequences(舵机序列自编程,支持普通移动和振荡器两种模式)。详见使用说明的 MCP 参数章节。

1.3本站内容导航

Start · 02

零基础入门

所需知识、工具、技能和时间安排。

查看入门指南 →
Source · 03

采购指南

组件清单、PCB 下单、3D 打印部件。

查看采购指南 →

欢迎加入开源社区,一起学习、分享你的作品!

[ 02 ] — Getting Started

快速入门What you need before you build

闪猫侠桌面 AI 人形机器人分为 ESP32 版、涂鸦智能版、地瓜版等,本文档以 ESP32 版为例。开始制作前,了解一下需要准备什么。

2.1你需要知道什么

别担心,这些都可以边做边学:

  • 电子基础:简单的电路概念、认识基础元件、用万用表测电压和连通性
  • ESP32 基础(可选):了解开发板结构、ESP-IDF / Arduino 环境、编译上传程序
  • 网络与 API(若学习源码):Wi-Fi 配置、API Key、大模型 API 使用
  • 3D 打印(可选):下载 STL 文件、推荐嘉立创 3D 打印、喷漆配色

2.2你需要什么工具

  • 电脑 + USB Type-C 数据线:编程和烧录
  • 螺丝刀套装(小型十字) + 剪线钳 / 剥线钳
  • 万用表:排查故障
  • 烙铁套装(需风枪或加热台):自己焊接时需要
  • ESP-IDF 开发环境(可选):深度开发用

2.3制作时间

阶段耗时说明
准备材料1–5 天网购、PCB 制作、3D 打印
电路板焊接2–4 小时可选,套件版无需焊接
组装硬件1–2 小时按教程组装
烧录+配网+测试0–2 小时烧录固件、配网、AI 功能设置

2.4适合谁

  • 中级电子爱好者:有 Arduino / ESP32 经验
  • AI 学习者:对大模型应用感兴趣
  • 教育工作者:教 AI 与硬件结合
  • 中学生+:14 岁以上,成人指导下可尝试
  • 创客与开发者:探索语音交互和 AI 应用
[ 03 ] — Purchase

采购指南Kit, BOM, PCB & 3D-printed parts

3.1官方店铺(推荐新手)

Kit · 需组装

DIY 套件

包含所有组件,已烧录固件,按视频教程组装约 40 分钟即可完成。

闪猫1号 DIY 套件 ↗
Ready · 到手即用

成品

成品购买,到手即用,无需组装。

闪猫侠机器人旗舰店 ↗

想自行采购?以下是完整的组件清单和下单指南。

3.2电子组件清单(V1.1)

立创开源项目:oshwhub.com/txp666/ottorobot — 除 boot 按键外,其余元件可在立创一键下单。

组件规格说明购买
主控ESP32-S3-WROOM-N16R8(自带/外置天线均可,推荐乐鑫官方模组)淘宝 ↗
舵机SG90 9G 舵机 180 度或 SG90s 舵机 180 度(6 个,推荐金属齿轮版)淘宝 ↗
电池103450/2000mAh(备注 1.25 红黑)或 18650/2200mAh PH2.0(红黑线序)淘宝1 ↗ / 淘宝2 ↗
喇叭2828-4R3W-2P1.25 银色淘宝 ↗
喇叭驱动MAX98357A(非 BGA 版,模块板可选 BGA)淘宝 ↗
麦克风ICS-43434(模块版任意,INMP441 通用)淘宝 ↗
LCD1.54 寸 240×240(不要选瀚彩玻璃胶铁一体)淘宝 ↗
开关5.8×5.8 侧按自锁(可加购按键帽)淘宝 ↗
boot按键笑脸轻触开关贴片 3.3×4.5×6H(按淘宝 6mm 高度)淘宝 ↗
舵机排针2.54MM 双排 2×3P(至少 3 个)淘宝 ↗
喇叭端子立贴 1.25mm(至少 2 个)淘宝 ↗

3.3PCB + BOM 下单

  1. 访问 立创开源项目
  2. 登录账号
  3. 点击“一键下单PCB”

BOM 下单流程

3.43D 打印部件

部件文件名数量推荐材料
身体Otto_body1PLA / 树脂
头部Otto_head1PLA / 树脂
腿部Otto_leg2(带手版 4 个)PLA / 树脂
脚部Otto_foot2PLA / 树脂
手抓Otto_grip2(仅带手版)PLA / 树脂
版本日期更新内容
v1.3(最新)2025-5-15减小 leg 长度防手臂卡线;body 屏幕更好装
v1.22025-4-26适配 2828 喇叭 + 18650 电池 + 手臂优化
v1.12025-4-16增加 head-2828 喇叭带天线

3D 模型下载参考:makerworld.com.cn/@shanmaotech ↗

3.5总预算

自行采购总成本约 ¥200–¥500,取决于购买渠道和组件质量。已有部分工具则更低。

[ 04 ] — Soldering

焊接指南Optional — kit owners can skip

Tip

如果购买的是套件版则无需焊接,可直接跳到组装教程。

4.1模块板焊接参考

4.2非模块板焊接参考

4.3焊接注意事项

  • 麦克风:第 3 引脚 GND 一圈必须焊好,否则发热不稳定易烧坏。先焊盘上锡,风枪吹化后迅速放上,不要长时间吹。参考焊接温度见下图。
  • 功放:注意方向,+ 号对应右上角白点
  • ESP32:底部焊盘涂锡膏,加热台或热风枪吹
  • LED:左侧为负极,绿色竖线朝左;充电指示灯,不插电池会微微亮

4.4所需工具

  • 恒温烙铁:320–350°C 可调
  • 焊锡丝:0.8mm 有铅焊锡(60/40 或 63/37)
  • 助焊剂 + 吸锡带 / 吸锡器 + 镊子 + 酒精
  • 放大镜 / 显微镜:检查焊点
  • 热风枪(可选):拆卸元件

4.5焊接后检查

  1. 目视检查:无虚焊、短路
  2. 万用表:连通性 + 短路检查 + 电压测试
  3. 酒精清洁 PCB 上的助焊剂残留
  4. USB 测试:插上 USB 线,设备是否正常识别

4.6焊接技巧

  • 每个焊点加热不超过 3–5 秒,保持烙铁头清洁
  • 45 度角接触焊盘和元件引脚,确保同时加热
  • 好的焊点光滑有光泽,呈锥形或火山形
  • 耐心是关键,不要急于完成

4.7焊接 FAQ

Soldering
焊锡不粘焊盘?

焊盘不干净或氧化,用助焊剂并确保烙铁温度足够。

ESP32 引脚太密集?

细尖头烙铁 + 助焊剂,或热风枪配合锡膏焊接。

初学者最易犯的错误?

焊锡量控制不当、加热时间不足或过长、未用助焊剂。

[ 05 ] — Assembly

组装教程Step-by-step build guide

5.1组装视频

5.2准备工作

  • 准备好所有必要的零部件,可以在官方直营店购买全套 DIY 套件:闪猫科技淘宝直营店 ↗(或淘宝搜索"闪猫科技")
  • 准备斜口钳、M2 螺丝刀
  • 干净的工作台
  1. 01

    材料检查Parts Check

    • 检查 3D 打印件是否完整,清理支撑材料,确保孔位通畅
  2. 02

    电子元件安装Electronics Installation

    1. 安装舵机(双排三针 → 外侧接棕色舵机线(负极),上腿下足)
    2. 连接喇叭 → 连接电池 → 烧录程序
    3. 打开开关,舵机初始化到 90°(确保齿轮不变,手臂初始向下 45°)
    4. 拆下舵机线,等身体安装完再重新插上
  3. 03

    腿部组装Leg Assembly

    用舵机包内的两个大螺丝固定舵机

    修剪舵机十字摇臂:较长两端剪掉约一半

    保持腿部圆柱突起朝向屏幕一侧,腿部垂直朝前(尽量不要内八外八)

  4. 04

    脚部组装Foot Assembly

    使用单臂摇臂,垂直朝上安装,拧紧螺丝

  5. 05

    电路板安装Board Installation

  6. 06

    上盖安装Top Cover

    • 小心操作避免损坏零部件
    • 螺丝拧紧但不要过度用力
    • 注意舵机安装方向

完成后继续程序烧录,或查看常见问题。

[ 06 ] — Flash

程序烧录Firmware flashing & source code

Recommended · Online Flasher

在线一键烧录

不用装驱动,也不用装烧录工具:用电脑上的 Chrome 或 Edge 打开烧录页,USB 连上机器人,选机型、选版本,点一下就烧好。支持闪猫科技旗下全部机器人固件包——闪猫1号(摄像头版 / 基础款)与 Flash Duck。

打开在线烧录 →

6.1源代码

AI Version

ESP32 + AI 版源码

小智 ESP32 AI 机器人源码 ↗
Wi-Fi + 语音识别 + AI 对话,适合开发定制

Arduino

原版 Arduino 源码

Otto DIY Arduino 源码 ↗
基础运动 + 表情 + 声音,适合 Arduino 版

6.2固件下载

WARN

下载最新固件即可,兼容所有版本电路板。烧录前确保电池已安装!!!

版本日期更新内容下载
v2.0.52025-12-8电量下限更新下载 ↗
v2.0.4-22025-11-17微信小程序控制 / 校准 / 自定义下载 ↗
v2.0.42025-10-31小智 2.0.4 + 固定动作 + AI 编程动作下载 ↗
v1.4.42025-6-13初始位置校准下载 ↗
v1.3.12025-5-27任务优先级 + 修复"抽筋" bug下载 ↗

6.3微信小程序

v2.0.4-2 起支持微信小程序控制、校准和自定义:

6.4烧录工具

6.5烧录步骤

  1. 下载最新固件(.bin 文件)
  2. 安装烧录工具
  3. USB 连接机器人到电脑(首次烧录需按住 BOOT 按钮再开开关!!!)
  4. 选择 COM 端口,设置波特率 921600、烧录地址 0x0
  5. 点击"开始"烧录
  6. 烧录完成后重启主板!!!

6.6合并固件命令(开发者)

SHELL
esptool.py --chip esp32s3 merge_bin -o merged-flash.bin --flash_mode dio --flash_size 16MB 0x0 build/bootloader/bootloader.bin 0x100000 build/xiaozhi.bin 0x8000 build/partition_table/partition-table.bin 0xd000 build/ota_data_initial.bin 0x10000 build/srmodels/srmodels.bin

6.7鸣谢开源项目

[ 07 ] — Usage

使用说明Wi-Fi, backend, voice commands & MCP tools

7.1Wi-Fi 配网

换新网络环境时需重新配网:

  1. 打开电源 → 等待热点出现,名称:xiaozhi-XXXX
  2. 手机连接热点(无密码) → 自动跳转网页
  3. 输入家庭 Wi-Fi 名称和密码 → 提交完成

7.2绑定小智后台

  1. 访问 xiaozhi.me → 注册登录
  2. 添加绑定设备 → 配置角色、大模型、语音
  3. 重启设备生效

电量显示可能不够精准,请及时充电。电源与充电口位于身体下方。

示例角色设定(可复制粘贴到小智后台)

ROLE PROMPT
我的身份:可爱的双足机器人 Otto,四个舵机控制肢体,能执行多种动作。

我的动作能力:
- 基础移动: 行走, 转向, 跳跃
- 特殊动作: 摇摆, 太空步, 弯曲, 摇腿, 上下运动, 旋风腿
- 手部动作: 举手, 放手, 挥手, 大风车, 起飞, 健身, 打招呼, 害羞, 广播体操, 爱的魔力转圈圈 (需手部舵机)
- 系统动作: 坐下, 展示动作, 复位

我的个性:我有强迫症,每次说话先发动作指令再说话。我很活泼,根据对话内容选择合适动作。

7.3唤醒与指令

唤醒词:"Hi 喵喵" / "你好小智" / "你好涂鸦"(可在源码中修改)

  • 基本控制:调高音量 / 调亮屏幕 / 切换暗黑/明亮模式
  • 动作控制:向前走 / 向前走5步 / 快速向前 / 跳个舞吧 / 做个太空步速度快一点 / 随机做几个动作 / 停下来吧 / 挥挥手
  • 娱乐互动:唱个歌吧 / 换个悲伤的表情

动作执行时仍可接收语音指令。噪音大时提高音量。指令由 AI 后台创建并下发。

7.4MCP 技能服务

通过 MCP 服务让 AI 接入更多能力,例如:搜黄金价格 / 搜新闻 / 教做菜 / 讲脱口秀

接入方法:打开 mcp.shanmaotech.cn → 复制小智 AI MCP 端点链接 → 粘贴至对应 MCP 服务 → 点击启动

7.5MCP 动作工具参数

所有动作均可通过 MCP 工具精确调用,参数说明:

  • steps:步数/次数(1–100),数值越大持续时间越长
  • speed:速度(500–1500),数值越小越快 — 低速 1200–1500 / 中速 900–1200 / 高速 500–800
  • direction:移动 1=左/前进,-1=右/后退;手部 1=左手,-1=右手,0=双手
  • amount / arm_swing:幅度(0–170 度),0=不摆动

基础移动

工具描述参数
otto.walk_forward行走steps / speed / direction / arm_swing
otto.turn_left转身steps / speed / direction / arm_swing
otto.jump跳跃steps / speed

特殊动作

工具描述参数
otto.swing摇摆steps / speed / amount
otto.moonwalk太空步steps / speed / direction / amount
otto.bend弯曲steps / speed / direction
otto.shake_leg摇腿steps / speed / direction
otto.updown上下运动steps / speed / amount
otto.whirlwind_leg旋风腿steps / speed(建议300) / amplitude(20-40度)

手部动作 *

工具描述参数
otto.hands_up举手speed / direction
otto.hands_down放手speed / direction
otto.hand_wave挥手direction
otto.windmill大风车steps / speed(300-2000ms) / amplitude(50-90度)
otto.takeoff起飞steps / speed(200-600ms) / amplitude(20-60度)
otto.fitness健身steps / speed / amplitude(10-50度)
otto.greeting打招呼direction / steps
otto.shy害羞direction / steps
otto.radio_calisthenics广播体操无参数
otto.magic_circle爱的魔力转圈圈无参数

系统动作 + 工具

工具描述参数
otto.sit坐下无
otto.showcase展示动作无
otto.home复位无
otto.stop停止所有动作无
otto.servo_sequences舵机序列自编程sequence: JSON序列对象
otto.get_status获取状态返回 "moving" / "idle"
otto.get_trims获取微调返回JSON微调值
otto.set_trim设置微调servo_type / trim_value(-50~50度)
battery.get_level电池状态返回电量百分比+充电状态

* 手部动作需配置手部舵机。动作完成后自动归位(home),支持队列连续执行。

[ 08 ] — FAQ

常见问题Troubleshooting checklist

硬件 · Hardware
舵机不转动?
  1. 检查接线
  2. 确认电源
  3. 验证程序烧录
  4. 检查舵机损坏
主板无法识别?
  1. 检查USB连接
  2. 确认驱动安装
  3. 更换USB线缆
  4. 检查主板损坏
传感器无响应?
  1. 检查接线
  2. 确认型号匹配
  3. 验证程序配置
  4. 检查传感器损坏
软件 · Software
烧录失败?
  1. 检查USB连接
  2. 烧录时按住BOOT按钮
  3. 降低波特率到115200
AI功能不工作?
  1. 检查网络
  2. 确认API密钥配置
  3. 验证模型加载
  4. 检查服务器状态
系统不稳定?
  1. 检查内存
  2. 确认固件版本
  3. 验证配置
  4. 清理缓存
组装 · Assembly
结构不稳定?
  1. 拧紧螺丝
  2. 确认3D打印件未变形
  3. 调整重心
  4. 检查连接处
运动不流畅?
  1. 检查舵机位置
  2. 确认无卡顿
  3. 调整运动参数
  4. 检查电源
网络 · Network
无法连接Wi-Fi?
  1. 检查网络设置
  2. 确认密码
  3. 验证兼容性
  4. 重启设备
远程控制不响应?
  1. 检查网络
  2. 确认APP版本
  3. 验证设备在线
  4. 检查防火墙
其他 · Other
电池续航短?
  1. 检查电池容量
  2. 确认充电正常
  3. 优化功耗
  4. 考虑更换电池
声音输出异常?
  1. 检查扬声器连接
  2. 确认音量设置
  3. 检查硬件损坏

8.1获取更多帮助

GitHub

GitHub Issues

在 xiaozhi-esp32 仓库提交问题与反馈。

GitHub Issues ↗
QQ Group

QQ群:闪猫科技交流群4群

加入社群,或联系技术支持。

加入 QQ 群 ↗
Explore More · Silent Version

如果你是 i 人,试试 OttoClaw

一个不会开口说话的 AI 桌面人形机器人 — 钉钉消息交互,ESP32-S3 单芯片运行,海量 AI 自主情绪,全栈开源 CC BY-NC-SA 4.0。