正在连接信源…

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.stl1
torso/torso_imu_holder.stl1
torso/torso_torso13.stl1
torso/torso_torso23.stl1
torso/torso_torso33.stl1
torso/torso_upper_torso_22.stl1
torso/torso_upper_torso_12.stl1
RobStride O0 · actuator · 22
M2 screw · M2 x 5 cyl head · 44
M2.5 screw · M2.5 x 20 cyl head · 99
M3 screw · M3 x 8 cyl head · 1212
M4 screw · M4 x 20 cyl head · 1616
M5 screw · M5 x 10 cyl head · 55
M3 screw · M3 x 35 cyl head · 44
Bearing · 35x72x17 · 22

物料 · Hips

零件数量
left_leg/hipz/hip_z_hipz12_sym.stl1
left_leg/hipz/hip_z_hipz22_sym.stl1
right_leg/hipz/hip_z_hipz12.stl1
right_leg/hipz/hip_z_hipz22.stl1
left_leg/hipx/hipx_2_hipxy_sym.stl1
right_leg/hipx/hipx_2_hipxy.stl1

采购

  • 采购公头线间连接器

    可视化目录将其标为公头线间连接器。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 训练环境,不含预训练策略(未声明许可证)

文档