OPEN SOURCE ★ FULLSTACK DIY

闪猫侠机器人开源生态

软硬件全栈开源AI桌面人形机器人,从零开始手搓你的桌面AI伙伴。30分钟即可打造专属桌面机器人。

LEVEL 01 ★ INTRO

闪猫1号 OttorobotAI版

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

闪猫1号 OttorobotAI版闪猫1号 OttorobotAI版

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

核心能力一览

闪猫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 / 文心一言
记忆短期记忆短期记忆短期 + 长期记忆(可选)
独家亮点涂鸦全生态智能家居语音控制更多语言 + 更多大模型 + 长期记忆

动作库

机器人拥有丰富的动作库,每个动作完成后自动归位(home),随时接收新指令:

类别动作说明
基础移动行走 / 转向 / 跳跃支持方向、步数、速度参数
特殊动作摇摆 / 太空步 / 弯曲 / 摇腿 / 上下 / 旋风腿支持幅度、速度参数
手部动作 *举手 / 放手 / 挥手 / 大风车 / 起飞 / 健身 / 打招呼 / 害羞 / 广播体操 / 爱的魔力转圈圈需配置手部舵机
系统动作坐下 / 展示 / 复位无参数,一键触发
高级功能舵机序列自编程支持普通移动和振荡器两种模式

* 手部动作仅在配置手部舵机时可用。所有动作均可通过语音指令或MCP工具调用,详见使用说明

本站内容导航

零基础入门

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

查看入门指南 ►

采购指南

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

查看采购指南 ►
欢迎加入开源社区,一起学习、分享你的作品!
LEVEL 02 ★ GETTING STARTED

快速入门

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

你需要知道什么

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

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

你需要什么工具

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

制作时间

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

适合谁

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

采购指南

官方店铺(推荐新手)

DIY套件(需组装)

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

闪猫侠机器人 DIY 套件 ►

成品(到手即用)

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

闪猫侠机器人旗舰店 ►

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

电子组件清单(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个)淘宝 ►

PCB + BOM 下单

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

PCB下单步骤1PCB下单步骤1
PCB下单步骤2PCB下单步骤2
PCB下单步骤3PCB下单步骤3
PCB下单步骤4PCB下单步骤4
PCB下单步骤5PCB下单步骤5
PCB下单步骤6PCB下单步骤6
PCB下单步骤7PCB下单步骤7

BOM下单流程:

BOM下单步骤1BOM下单步骤1
BOM下单步骤2BOM下单步骤2
BOM下单步骤3BOM下单步骤3
BOM下单步骤4BOM下单步骤4
BOM下单步骤5BOM下单步骤5
BOM下单步骤6BOM下单步骤6

3D打印部件

部件文件名数量推荐材料
身体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 ►

总预算

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

LEVEL 04 ★ SOLDERING

焊接指南

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

模块板焊接参考

模块板1模块板2
模块板3模块板4
模块板5模块板6

非模块板焊接参考

非模块板7非模块板8

焊接注意事项

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

所需工具

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

焊接后检查

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

焊接技巧

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

焊接FAQ

焊锡不粘焊盘?
焊盘不干净或氧化,用助焊剂并确保烙铁温度足够。
ESP32引脚太密集?
细尖头烙铁+助焊剂,或热风枪配合锡膏焊接。
初学者最易犯的错误?
焊锡量控制不当、加热时间不足或过长、未用助焊剂。
LEVEL 05 ★ ASSEMBLY

组装教程

组装视频

准备工作

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

Step 1 — 材料检查

  • 检查3D打印件是否完整,清理支撑材料,确保孔位通畅
所有材料准备所有材料准备

Step 2 — 电子元件安装

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

Step 3 — 腿部组装

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

组装腿部舵机组装腿部舵机
完成腿部舵机完成腿部舵机组装

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

修剪摇臂修剪舵机十字摇臂
安装摇臂安装十字摇臂到腿部

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

固定腿部固定腿部并拧紧螺丝

Step 4 — 脚部组装

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

脚部舵机摇臂固定脚部舵机摇臂
固定脚部固定脚部
舵机线穿到身体脚部舵机线穿到身体
脚部安装脚部安装
脚部固定螺丝脚部舵机固定螺丝

Step 5 — 电路板安装

固定喇叭固定喇叭(有线的开槽)
安装舵机线安装好舵机线、喇叭、电池、天线
安装主板安装主板
屏幕充电口确保屏幕、Type-C充电口和开关到位

Step 6 — 上盖安装

脑袋上盖上盖前侧突起压紧电路板

注意事项

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

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

LEVEL 06 ★ FLASH

程序烧录

源代码

ESP32+AI版源码

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

原版Arduino源码

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

固件下载

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

版本日期更新内容下载
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下载 ►

微信小程序

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

微信小程序二维码微信小程序二维码

烧录工具

烧录步骤

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

合并固件命令(开发者)

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

鸣谢开源项目

LEVEL 07 ★ USAGE

使用说明

Wi-Fi配网

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

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

绑定小智后台

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

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

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

我的身份:可爱的双足机器人 Otto,四个舵机控制肢体,能执行多种动作。 我的动作能力: - 基础移动: 行走, 转向, 跳跃 - 特殊动作: 摇摆, 太空步, 弯曲, 摇腿, 上下运动, 旋风腿 - 手部动作: 举手, 放手, 挥手, 大风车, 起飞, 健身, 打招呼, 害羞, 广播体操, 爱的魔力转圈圈 (需手部舵机) - 系统动作: 坐下, 展示动作, 复位 我的个性:我有强迫症,每次说话先发动作指令再说话。我很活泼,根据对话内容选择合适动作。

唤醒与指令

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

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

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

MCP技能服务

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

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

MCP动作工具参数

所有动作均可通过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),支持队列连续执行。

LEVEL 08 ★ FAQ

常见问题

硬件

舵机不转动?
检查接线 → 确认电源 → 验证程序烧录 → 检查舵机损坏
主板无法识别?
检查USB连接 → 确认驱动安装 → 更换USB线缆 → 检查主板损坏
传感器无响应?
检查接线 → 确认型号匹配 → 验证程序配置 → 检查传感器损坏

软件

烧录失败?
检查USB连接 → 烧录时按住BOOT按钮 → 降低波特率到115200
AI功能不工作?
检查网络 → 确认API密钥配置 → 验证模型加载 → 检查服务器状态
系统不稳定?
检查内存 → 确认固件版本 → 验证配置 → 清理缓存

组装

结构不稳定?
拧紧螺丝 → 确认3D打印件未变形 → 调整重心 → 检查连接处
运动不流畅?
检查舵机位置 → 确认无卡顿 → 调整运动参数 → 检查电源

网络

无法连接Wi-Fi?
检查网络设置 → 确认密码 → 验证兼容性 → 重启设备
远程控制不响应?
检查网络 → 确认APP版本 → 验证设备在线 → 检查防火墙

其他

电池续航短?
检查电池容量 → 确认充电正常 → 优化功耗 → 考虑更换电池
声音输出异常?
检查扬声器连接 → 确认音量设置 → 检查硬件损坏

获取更多帮助

LEVEL 09 ★ SHOWCASE

社区二次开发

展示社区创客们的二次开发作品,欢迎大家投稿分享你的创意与作品。

作品招募中

如果你基于闪猫侠机器人做了有趣的二次开发,欢迎投稿展示你的作品!