LeRobot Humanoid 双足平台(Hugging Face 开源低成本人形机器人) 复刻全流程
LeRobot Humanoid 双足平台(Hugging Face 开源低成本人形机器人) 从采购、打印、组装到装软件、标定和训练的 114 个步骤,附物料表、购买链接与官方出处。
不出售整机或套件。硬件 README 的成本估算(双足平台,2026‑04‑30,美元,仅供参考、随供应商变动):采购件小计 2,579.84,加约 3.5 kg PLA+ 耗材 56.00,合计约 2,635.84;不含运费、进口关税与当地税,欧元报价按 1 欧元 = 1.1691 美元(2026‑05‑05)换算,螺丝按批量单价估。大头是 12 个电机:RobStride O3 每个 225(共 900)、O5 每个 110(440)、O2 每个 145(290)、O0 每个 125(250);树莓派 5 130、IMU 64、CAN‑FD 适配器 59、8 个球头杆端共 167.44。发布文称零件约 2,500 美元,视采购、运费与税费而定。不含 3D 打印机与工具(只列一把 2.5 mm 内六角)
物料 · Torso
| 零件 | 数量 |
|---|---|
| torso/torso_can_holder.stl | 1 |
| torso/torso_imu_holder.stl | 1 |
| torso/torso_torso13.stl | 1 |
| torso/torso_torso23.stl | 1 |
| torso/torso_torso33.stl | 1 |
| torso/torso_upper_torso_22.stl | 1 |
| torso/torso_upper_torso_12.stl | 1 |
| RobStride O0 · actuator · 2 | 2 |
| M2 screw · M2 x 5 cyl head · 4 | 4 |
| M2.5 screw · M2.5 x 20 cyl head · 9 | 9 |
| M3 screw · M3 x 8 cyl head · 12 | 12 |
| M4 screw · M4 x 20 cyl head · 16 | 16 |
| M5 screw · M5 x 10 cyl head · 5 | 5 |
| M3 screw · M3 x 35 cyl head · 4 | 4 |
| Bearing · 35x72x17 · 2 | 2 |
物料 · Hips
| 零件 | 数量 |
|---|---|
| left_leg/hipz/hip_z_hipz12_sym.stl | 1 |
| left_leg/hipz/hip_z_hipz22_sym.stl | 1 |
| right_leg/hipz/hip_z_hipz12.stl | 1 |
| right_leg/hipz/hip_z_hipz22.stl | 1 |
| left_leg/hipx/hipx_2_hipxy_sym.stl | 1 |
| right_leg/hipx/hipx_2_hipxy.stl | 1 |
采购
- 采购公头线间连接器
可视化目录将其标为公头线间连接器。XH-2A / XH-2Y 是线间连接的商用参考型号。
- 采购母头线间连接器
可视化目录将其标为母头线间连接器。XH-2A / XH-2Y 是线间连接的商用参考型号。
- 采购 RobStride O3 端连接器
采购图中所示 RobStride 电机连接器的 O3 端连接器。该目录将 O3 端连接器与其他 RobStride 型号分开标识。
- 采购其他 RobStride 型号连接器
采购本机器人使用的其他 RobStride 型号对应的连接器。该目录将其与 O3 端连接器区分开来。
- 采购 XT30 电源连接器
XT30 用于连接电源。其黄色电源连接器外壳可在上述连接器照片中看到。
- 选择双足硬件目标
双足平台是当前用于启动调试、标定、数据采集、系统辨识和早期运动实验的版本。
- 查阅硬件物料清单
lerobot-humanoid-hardware 仓库包含机器人的物料清单。
打印与加工
- 选择 Bambu Lab H2D 打印机
打印所有机器人部件时,以 Bambu Lab H2D 作为打印机基准。
- 使用 PLA+ 打印材料
所有机器人打印部件均以 PLA+ 为材料基准。
- 设置打印参数
设置 30% 填充、4 层墙、0.15 mm 层高、gyroid 填充图案和 0.2 mm 喷嘴。
- 按受力方向调整结构件
打印结构件时调整方向,使层纹不承受主要拉伸载荷。
- 检查方向参考照片
检查 thigh_detail.jpg、knee_detail.jpg 以及三张 knee_mechanism_view 照片中的层纹方向和最终部件姿态。
- 查看 H2D 配置映射
查看 docs/manufacturing/h2d_profiles/README.md,以快速对应 H2D 参考配置文件。
- 打印 shin 胫骨部件
使用 shin_tibias_example.3mf 作为 shin 胫骨部件的 H2D 参考项目文件,并参考 shin_tibias_print_example.png 检查打印结果。
- 打印 thigh 股骨部件
使用 thigh_femur_example.3mf 作为 thigh 股骨部件的 H2D 参考项目文件,并参考 thigh_print_example.png 检查打印结果。
- 打印 hip 髋部部件
使用 hip_example.3mf 作为 hip 部件的 H2D 参考项目文件,并参考 hip_print_example.png 检查打印结果。
- 打印其他部件并确认方向
其他部件通常采用一种明显安全的打印方向;若方向不明确,则用 Onshape 和已安装组件照片确认。
- 打印躯干
打印躯干子组件。
- 打印髋部 Z
打印 hipz 子组件,并使用 100% 填充。参考项目文件为 `docs/manufacturing/h2d_profiles/hip_example.3mf` 和 `docs/manufacturing/h2d_profiles/hip_print_example.png`。
- 打印髋部 X
打印 hipx 子组件,并使用 100% 填充。
- 打印大腿
打印大腿子组件。对于较大的大腿部件,应侧向打印,不要正面打印。参考项目文件为 `docs/manufacturing/h2d_profiles/thigh_femur_example.3mf` 和 `docs/manufacturing/h2d_profiles/thigh_print_example.png`。
- 打印膝部机构
打印膝部机构子组件。
- 打印小腿
打印小腿子组件。参考项目文件为 `docs/manufacturing/h2d_profiles/shin_tibias_example.3mf` 和 `docs/manufacturing/h2d_profiles/shin_tibias_print_example.png`。
- 打印脚踝机构
打印脚踝机构子组件。
- 打印脚踝
打印脚踝子组件。
- 打印脚部
打印脚部子组件。
- 查找可打印零件
lerobot-humanoid-hardware 仓库包含机器人的可打印零件。
- 检查间隔件打印覆盖范围
在相关子装配章节中检查间隔件 STL 列表。间隔件子装配为 `shin`、`ankle_mechanism`、`ankle` 和 `foot`;非间隔件子装配为 `torso`、`hipx`、`hipz`、`thigh` 和 `knee_mechanism`。
组装
- 准备三条腿部子线缆
按照 `hardware/electronics/cabling/README.md` 准备 shin、thigh 和 hip pass-through 三种子线缆。
- 安装小腿子线缆
在 `shin` 装配过程中安装 shin 子线缆,并在最终封闭前完成。
- 安装大腿子线缆
在 `thigh` 装配过程中安装 thigh 子线缆,并在最终紧固前完成。
- 布置髋部贯穿子线缆
在 `hipz` 集成过程中布置 hip pass-through 子线缆。
- 连接腿部线缆与躯干线束
在最终将腿部安装到躯干时,把腿部线缆连接到躯干线束。
- 确认躯干电机支架方向
将两个电机的端口朝向机器人内侧,并使其中一个内侧螺孔与 torso13 的槽对齐。
- 安装躯干RobStride电机
将两个 RobStride O0 电机分别放入 torso_torso23 和 torso_torso33 电机支架。每个支架用六枚 M3x8 螺钉固定。
- 插入躯干轴承
将两个 35x72x17 轴承插入 torso_13.stl 的槽中。
- 组装下躯干电机支架
将每个电机支架子装配放在轴承堆叠上方,用八枚 M4x20 螺钉固定,并让电机线缆朝向内侧。
- 安装CAN总线支架
将 CAN 总线支架安装到组件底部,不使用螺钉固定。支架底部伸出的部分嵌入下部组件的槽中。
- 固定躯干CAN总线
将 CAN 总线放到 CAN 总线支架上,并使用 torso_can_holder_2.stl 和四枚 M3x35 螺钉固定。
- 连接躯干上部零件
使用五颗 M5x10 螺钉连接 torso_upper_torso_22 和 torso_upper_torso_12。两端的螺钉应先松装,因为下一步会将其拧紧。
- 组合上下躯干
将上部组件放到下部组件上,然后拧紧上部组件两端的螺钉。
- 安装树莓派和 IMU
使用四颗 M2.5x20 螺钉,将带 IMU 支架的 Raspberry Pi 安装到上部组件顶部。不要过度拧紧,以免损坏没有足够底部空间的树莓派。
- 固定 IMU
使用四颗 M2x5 螺钉,将 IMU 安装到 IMU 支架顶部。IMU 的引脚应焊接成从电路板“正面”伸出。
- 安装髋关节轴承
将 35x72x17 轴承插入 hip_z_hipz22 和 hip_z_hipz22_sym。
- 插入髋关节电机
将 RobStride O2 电机插入 hip_z_hipz12 和 hip_z_hipz12_sym。插入前再次确认电机对应的髋关节零件。
- 固定髋关节电机
分别使用九颗 M3x10 螺钉,将 RobStride O2 电机固定到 hipz12 和 hipz12_sym。
- 对准髋关节与电机
分别使用三颗 M3x10 螺钉和三根销钉,将 hip_z_hipz12 和 hip_z_hipz12_sym 安装到电机 1 和电机 7。安装前确认孔位,因为电机插入后很难旋转或取出;作者使用过 13 cm 的内六角扳手。
- 布置髋关节线缆
按照 `hardware/electronics/cabling/README.md`,将髋关节贯穿子线缆穿过 hipz。
- 完成成对髋关节
将 hipz22 和 hipz22_sym 分别连接到 hipz12 和 hipz12_sym。下侧使用四颗 M4x45 螺钉,上侧使用六颗 M4x40 螺钉固定。
- 安装髋 X 组件
将 hipx_2_hipxy 和 hipx_2_hipxy_sym 分别插入刚完成的髋 Z 组件对应位置。每个组件使用六颗 M4x12 螺钉固定到 RobStride O2 电机。
- 插入髋关节轴承
将一个 15x21x4 轴承压入 `hipxy` 的关节孔。可在轴承槽中涂上 WD-40,并用锤子的平面轻轻敲入到位。
- 插入股骨部件
将 `femur_22` 插入轴承与 `hipxy` 中。
- 固定股骨端盖
使用三枚 M2.5 x 6 螺钉,将 `femur_hat_small_1` 固定在 `femur_22` 上,并覆盖轴承以固定该部件。
- 调整电机背面螺钉
对本子组件使用的所有 RobStride O3 电机,按说明调整背面螺钉:从一个数据/电源接口旁拆下两枚螺钉,并将其装入电机另一侧的空白螺孔。
- 安装顶部股骨电机
将 RobStride O3 ID 3 推入 `femur_12`;左腿使用 ID 9。对齐没有螺钉的孔与 `femur_12` 的开口,并用四枚 M4 x 10 螺钉固定。
- 连接股骨与髋部
使用六枚 M4 x 20 螺钉,将 `femur_12` 连接到 `hip_xy`。确保 `femur_22` 与 `femur_12` 对齐并严密贴合。
- 安装并布置大腿线束
在最终封闭之前安装并布置大腿子线束,遵循 `hardware/electronics/cabling/README.md`。
- 连接两段股骨部件
在顶部电机附近使用四枚 M4 x 30 螺钉,在下部使用两枚 M4 x 16 螺钉,将 `femur_12` 连接到 `femur_22`。下部孔较松时,可在两条腿上各加入两个 M4 螺纹热熔螺母,但需小心操作。
- 安装第二个股骨电机
将第二个 RobStride O3 电机(ID 4 或 10)插入股骨,并用四枚 M4 x 10 螺钉从两侧各固定四枚。若此前未调整电机螺钉,此时进行调整。
- 两只脚重复操作
对两只脚执行相同的脚和脚踝组装步骤。
- 安装前端球形关节
在每只脚前端的缺口之间安装两个球形关节。在每个球形关节两侧放置一个5x6x3隔套,用两颗5x20肩螺钉固定,并用M4螺母锁紧肩螺钉。
- 安装后端轴承
将两个5x16x5轴承放入每只脚后端的槽中,用均匀而稳定的压力使其就位。
- 组装脚踝关节
在后端轴承之间放置U形接头,并在其两侧放置U形接头隔套。使用5x40肩螺钉和M4螺母固定,再将foot_hat_small覆盖在后端轴承上,用三颗M2.5x8螺钉固定。
- 安装膝部执行器轴承
在膝部执行器两侧各放置一个15x21x4轴承。
- 安装并对准膝部连杆
将knee_rod12和knee_rod22安装到膝部执行器上,对准后用三颗M3x18螺钉固定。确认方向,使该机构能够带动胫骨远离股骨,且不与机器人其他部件碰撞。
- 暂放膝部子组件
将完成的膝部子组件放在一旁,下一步末尾会使用它。
- 安装小腿轴承和销钉
在每个小腿的槽内插入两个 15x21x4 轴承,并在小腿顶部和底部各插入一个销钉。配合非常紧,可用 WD-40 润滑并轻敲安装;若开裂,可用烙铁熔接修复。
- 安装小腿电机
将 RobStride o5 电机安装到小腿上,使线缆朝向前侧,即没有顶部轴承的一侧。确认两个小腿半体的背部开口互相对齐,并用八个 M3x10 螺钉固定。
软件与固件
- 打开主仓库概览
从主 lerobot-humanoid 仓库开始,了解完整技术栈。
- 打开运行时仓库
进行机器人控制与部署时,使用 lerobot-humanoid-runtime。
标定与测试
- 仅接通控制器逻辑电源
首次测试仅给控制器逻辑电源供电。
- 将限流设为 2 安培
首次测试阶段将台式电源限流设为 `2 A`,此时不应具备运动能力。
- 确认最大空闲电流
确认预期空闲电流约为 `1 A`,且不应超过该值。
- 电流超限立即停止
如果电流升至 `2 A` 以上,立即停止并在继续前重新检查接线。
- 确认所有节点通信
确认已与所有控制器节点建立通信。
- 验证看门狗和心跳
检查看门狗和心跳行为是否正常。
- 设置较低电流和扭矩限制
在执行器通电测试前,将电流和扭矩限制设为较低值。
- 每次启用一个执行器
一次只启用一个执行器,然后检查该执行器。
- 验证方向和编码器一致性
验证运动符号或方向以及编码器读数的一致性。
- 异常运动时立即禁用
如果出现意外运动,立即禁用执行器。
- 在中位附近执行微小运动
围绕中立位置执行幅度极小的运动命令。
- 确认软件限制已生效
确认软件限制已得到执行。
- 停止异常发热异味噪声或振荡
出现意外发热、异味、噪声或振荡时停止。
- 负载下通信不稳时停止
负载下出现通信不稳定时停止。
- 限制或安全不匹配时停止
出现任何限制或安全设置不匹配时停止。
- 部署控制器前标定机器人
在真实机器人上部署学习控制器前完成标定。
- 执行机器人安全检查
在真实机器人上部署学习控制器前进行安全检查。
- 使用低增益进行测试
在真实机器人上部署学习控制器前进行低增益测试。
- 确保可靠的断电装置
部署学习控制器前准备好可靠的断电装置。
- 使用运行时机器人工具
运行时提供标定、状态读取、命令发送和安全检查工具。
- 检查躯干电机转动
紧固后确认两个躯干电机输出均可自由旋转。
- 检查髋关节活动
确认髋关节能够自由运动。从 hipz12 或 hipz12_sym 伸出的长零件与下部躯干底部缺口接触时,可能发出轻微咔哒声。完成这些步骤后,腿式机器人的上部组件即已完成。
- 检查脚踝活动
紧固后确认脚踝能够自由活动。
采数据与训练
- 在真实机器人上运行学习策略
视频展示了早期仿真到现实的站立策略在双足平台上的运行。
- 重放数据集并拟合仿真器参数
lerobot-humanoid-identification 仓库提供在仿真中重放真实数据集和拟合仿真器参数的工具。
- 在 MJLab 环境中训练策略
lerobot-legged-zoo 为 LeRobot Humanoid 和其他腿式机器人提供 MJLab 训练环境。
- 记录偏移和运行备注
记录观察到的偏移量和运行备注,供以后集成到 `lerobot_humanoid_runtime` 时使用。
物料
- 12 个 RobStride 关节电机:躯干 O0 ×2、髋 z O2 ×2、大腿 O3 ×4、小腿 O5 ×4
- 树莓派 5、BNO055 或 BNO085 IMU、SAVVYCANFD 双通道 USB CAN‑FD 适配器(README 称是目前唯一验证能处理 RobStride CAN 协议的适配器)
- 轴承:35×72×17 ×4、15×21×4 ×14、5×16×5 ×8;8 个 Norelem 27628 球头杆端(踝部连杆)与 12 根 Norelem 07534 轴肩螺丝
- 75 个 3D 打印件,约 3.5 kg PLA+(目标 3–4 kg);髋 z 与髋 x 零件用 100% 填充
- 5 m 红黑电源线与两色通信线、XT30 主电源接头、XH 线间接头;几百颗 M2–M5 螺丝、M4 螺母、M3 热熔铜螺母与定位销
工具
- 3D 打印机:基准为 Bambu Lab H2D,0.2 mm 喷嘴,PLA+,30% gyroid 填充、4 层壁、0.15 mm 层高
- 2.5 mm 内六角扳手(列在物料表里)、压装轴承用的压具或小锤、低速扩孔用的金属钻头
- 限流台式电源(首次上电限流 2 A)与随手可及的物理断电开关
- 训练策略需要带 CUDA 的 GPU(lerobot-legged-zoo README)
技能
- 装配前用 commission_motor.py 向导逐个配置电机:识别协议与 ID、切换到 MIT 协议、分配 ID、做运动检查
- 制作小腿、大腿与髋部三段腿部线束,完成接线检查与分阶段上电
- 按 Onshape 装配方向装电机与轴承,塑料螺纹约 5 N·m
- Linux、Python 与 uv;零位与 IMU 标定、MuJoCo 仿真、用 MJLab 训练强化学习策略
软件
- lerobot-humanoid-runtime:MuJoCo 仿真与真机控制(CAN MIT 协议加安全检查)、ONNX/Torch 策略运行、IMU 后端、手柄指令、LeRobot 集成与标定工具(Apache‑2.0)
- lerobot-humanoid-identification:用 MJWarp 回放真机数据、以 CMA‑ES 拟合仿真参数(Apache‑2.0)
- lerobot-humanoid-model(MJCF/URDF 模型)与 lerobot-humanoid-design(URDF 与最优控制协同设计),均为 Apache‑2.0
- lerobot-legged-zoo:MJLab 训练环境,不含预训练策略(未声明许可证)