Reachy Mini 六自由度开源桌面机器人完整指南从装到通电到第一次点头的实操路线【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini先说个具体场景孩子写完一段 Python保存运行的瞬间桌上那个 Reachy Mini 小机器人转过头看屏幕两根天线晃了晃。这就是本文要带你跑通的东西——一台完全开源的桌面机器人9 个 Dynamixel 智能电机驱动头部六自由度运动能看、能听、能说话还能跟着声音转头。项目速览这是什么、值不值得做Reachy Mini 由 Pollen Robotics 开源定位是给黑客和 AI 开发者用的有表达力的机器人。硬件为 3D 打印件 常见电子件软件提供 Python SDK、JavaScript SDK 和一套桌面控制 App生态里还有可一键安装的社区应用商店。它有三个版本Wireless 版内置树莓派 CM4 锂电池独立运行含 IMULite 版USB 连接你的电脑供电由电脑负责适合开发和教学模拟版基于 MuJoCo无需任何硬件即可写代码调试项目说明主控硬件Raspberry Pi CM44GB 内存/16GB 存储Lite 版用你的电脑自由度头部 6 自由度3 转 3 平移 身体旋转 双天线感知配置120° 广角 12MP 自动对焦摄像头、4 麦克风阵列、5W 扬声器预算参考套件约 2500 元Lite 更便宜DIY 打印件可进一步降低难度新手友好无需焊接最难的是理线制作周期组装 1.5~4 小时 首次配置约 30 分钟一个周末足够动手篇物料清单与最快调通步骤物料清单套件模式下盒内已含全部工具DIY 模式下按下表准备物料规格用途结构件3D 打印件仓库内提供 STL机身、底座、头部外壳电机9× DynamixelXC330-M288底座 6× XL330-M288斯图尔特平台 2× XL330-M077天线全部运动执行主控Raspberry Pi CM4仅 Wireless 版跑 daemon 与 App感知广角摄像头 4 麦阵列reSpeaker XVF3800 5W 喇叭视觉与音频电源7V-5A 电源Lite/ LiFePO4 2000mAh 电池Wireless供电与续航工具螺丝刀套装即可套件已附全套组装分步实操 下载代码与模型资产需 Git LFSgit clone https://gitcode.com/GitHub_Trending/re/reachy_mini 组装机身跟着官方数字指南 视频一步步来预留 1.5~4 小时。最棘手的两处是理线和把球形关节的螺丝拧紧到合适扭矩其余都是按图索骥。装完盒内会多出几根线缆和螺丝那是备件不用装。 首次上电配置Wireless 版开机后手机/电脑会搜到机器人热点安装 Reachy Mini Control 桌面 App点First time connecting...按向导连上家里 WiFi然后在设置里检查一次系统更新。Lite 版电源适配器 USB-C 数据线连电脑打开 Control 桌面 App 即可ARM64 等特殊系统装不了 App 时直接用 Python SDK 也是官方支持的。 在电脑端装 SDKPython 3.10~3.12推荐用 uvuv venv reachy_mini_env --python 3.12 source reachy_mini_env/bin/activate uv pip install reachy-mini 跑第一个脚本hello.py天线左右摆一下就算调通from reachy_mini import ReachyMini with ReachyMini() as mini: mini.goto_target(antennas[0.5, -0.5], duration0.5) mini.goto_target(antennas[0, 0], duration0.5)运行python hello.py机器人动起来了。验证 daemon 是否健康也可以看浏览器里http://reachy-mini.local:8000/docsWireless或http://localhost:8000/docsLite的 API 页面。更多细节见官方快速上手文档。原理篇三个最值得搞懂的设计头部为什么用斯图尔特平台而不是机械臂头部由 6 根线性电机杆件撑起一个并联机构3 根转 3 根平移合成 6 自由度俯仰、偏航、横滚全都能做。为什么这样设计头上面要背摄像头、麦克风阵列和Wireless 版整个计算单元串联机械臂的误差会沿臂累积、末端刚度差并联结构的误差几乎不累积、刚度高、响应快而且天然适合做拟人化的转头 点头组合动作。代价是反向运动学复杂好在项目内置了解析解、神经网络onnx和 Placo 三种运动学后端SDK 里直接调goto_target(headcreate_head_pose(...))就行。9 个智能电机 50Hz 控制环为什么这么稳所有关节都是 Dynamixel 总线智能电机TTL 串行挂在一条总线上PID 位置控制跑在电机固件里主机每周期只发目标值。daemon 里的控制环以约 50Hz周期 ≈ 20ms读写电机你可以在/api/daemon/status里看到ControlLoopStats(period~19.99ms)。为什么这样设计把实时控制下沉到执行器树莓派这种算力有限的主机只做插值和调度延迟稳定、CPU 占用低运动平滑性则由goto_target的插值方法minjerk、ease_in_out、cartoon决定手势类动作用平滑插值遥操作类高频控制用set_target直达。软件层还有一组安全限位兜底头部俯仰/横滚 ±40°、身体偏航 ±160°、头-身偏航差 ≤65°越界指令会被自动钳到最近的合法位姿。电子系统一块电源板 客户端/服务器架构硬件侧电源板统一处理 6.8~7.6V 输入、锂电池充放电和过充/过流/短路保护BMS 带温度传感器音频走 reSpeaker XVF3800 四麦阵列自带回声消除 5W 喇叭摄像头是 RPi v3 广角模组CSI 直连 CM4。软件侧则是典型的 client-serverdaemon 独占硬件 I/O、安全检查和传感器读取对外暴露:8000的 REST API 和 WebSocket/api/state/ws/full可订阅关节状态流Python SDK、JavaScript SDK、桌面 App 都只是客户端。为什么这样设计AI 逻辑可以放在任何一台有网的机器上——你的电脑、手机甚至云端——机器人只负责硬件执行这也是为什么 Web App 能通过 WebRTC 从浏览器直接遥控机器人零安装。扩展与二开从跑通到玩出花样从示例起步examples/ 里有 17 个可直接运行的脚本——人脸追踪、听声辨位、录制回放动作、Rerun 可视化教程 Notebook 按连接→运动→摄像头→音频的顺序讲一遍。对话与 AI 集成官方 Conversation App 是 VAD LLM TTS 的完整参考实现接自己的 LLM 时用media_backendno_media关掉内置媒体管线直接拿原始麦克风和摄像头数据。浏览器应用JavaScript SDK 让你把机器人应用做成静态页面通过 WebRTC 从任何浏览器含手机遥控是目前官方推荐的新应用形态。发布与共享reachy-mini-app-assistant create my_app /path --publish一条命令生成标准 App 结构并发布到社区应用商店别人在 Control App 里一键安装。无硬件玩法reachy-mini-daemon --sim启动 MuJoCo 模拟代码逻辑先跑通再上真机。进阶路径调 PIDhardware_config.yaml里按电机 ID 调先试 P180、D10→ 装 Placo 运动学后端解锁重力补偿enable_gravity_compensation可以让机器人被手拖着走→ 换装社区在分享 3D 打印外壳皮肤仓库 assets 目录下的 STL 支持自己打印补件。避坑指南常见故障排查先记住总原则任何疑难杂症先更新软件 重启机器人按 OFF等 5 秒再 ON这能解决一半以上的问题。然后按下面的流程走几个高频单项问题命令执行成功但机器人不动多半是电机处于 Disabled 模式睡眠后或wake_up()单独调用过。查get_status()的motor_control_mode执行mini.enable_motors()再动。麦克风录音全静音/全零9 成是 FPC 扁平线插反了——蓝面朝上或印有 Main Board 字样朝上。所有 App 起不来、但头能动daemon 启动时依赖摄像头先查摄像头排线是否插牢、方向正确Wireless 版可用rpicam-hello --list-cameras确认是否识别到 imx708。天线竖立时抖0° 位是逆摆式不稳定平衡点齿轮背隙会诱发振荡。现在固件默认给天线加 10° 偏移已规避老机器可手动偏移或微调 PID。Linux 上音量小alsamixer把 PCM1 拉满 100%再持久化保存。更多细节以官方排障文档为准它覆盖的条目比这里多得多。写在最后Reachy Mini 把装一台机器人压缩到了周末量级打印件 套件、2~4 小时组装、30 分钟配网然后你拥有的不是一台成品而是一个带应用商店、开放 REST API 和完整 SDK 的平台。剩下的自由度——比喻和字面意义上的——都在你手里。现在就可以行动把套件拆出来或先跑一把--sim模拟今晚让它的天线晃起来。【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考