正在连接信源…

XLeRobot 复刻全流程

XLeRobot 从采购、打印、组装到装软件、标定和训练的 77 个步骤,附物料表、购买链接与官方出处。

基础版(笔记本 + 单 RGB 头部相机)约 660 美元或 3,999 元;不含 3D 打印、工具、运费与税。可选:双目相机 +30 美元、树莓派 +79 美元、RealSense +220 美元

采购

  • 比较各地区物料成本

    查看物料清单中的 US、EU、CN 和 IN 价格。总价不包括 3D 打印、工具、运输和税费。

  • 购买打印件或预组装套件

    可从 Wowrobo 购买 SO101 机械臂的 3D 打印件或预组装套件。

  • 选择性核对现有机械臂

    如果已有 SO101 机械臂或 Lekiwi,只需选择性参考此物料清单。也可检查 SO100 和 Lekiwi 仓库,寻找可能更便宜的选择。

  • 准备缺少的组装工具

    如果尚未拥有表中列出的工具,则购买这些组装工具。已有全部工具时可跳过本节。

  • 采购功能部件

    按照功能部件表选择并购买所需部件及数量。

  • 采购电子元件

    按照电子元件表选择并购买所需电子元件及数量。

  • 获取舵机版或自行购买零件

    可直接在 wowrobo 购买该版本,也可以自行购买除 3D 打印件和舵机之外的所需零件。

  • 以 Bracket Bot 为基础

    以 Bracket Bot 机器人为基础制作无刷电机版本。

  • 购买预装配套件

    也可以购买用于 SO101 机械臂的预装配套件。

  • 准备 IKEA 购物车

    准备一个 IKEA 购物车作为机器人的购物车底座。

  • 购买材料清单中的零件

    按照BOM.md材料清单购买零件。总成本不包括3D打印、工具、运输和税费。

  • 购买机器人零件

    按照链接中的物料清单购买零件。

打印与加工

  • 下载 XLeRobot 0.3.0 打印文件

    下载用于 3D 打印的 XLeRobot 0.3.0 .3mf 文件。

  • 摆放方向并添加支撑

    自行摆放和定向模型,并添加支撑,以确保最佳打印质量。

  • 使用 TPU95A 打印软 Finray 手指

    .3mf 文件包含软 Finray 手指,需要使用 TPU95A 打印。

  • 选择原始 SO101 手指文件

    如果需要原始 SO101 手指,下载原始 SO101 .stl 文件。

  • 选择头部摄像头连接器版本

    .3mf 文件包含两个单 RGB 头部摄像头连接器与外壳版本:一个用于 webcam 和 RealSense,另一个用于与手部摄像头相同的低成本摄像头。

  • 打印底座支撑垫圈

    这次无需调整底座连接器,只需打印垫圈。

  • 选择 D435 云台俯仰支架

    对于 Intel RealSense D435 或类似的 RGBD 摄像头,使用 Gimbal_Pitch_Holder_d435.stl。

  • 选择 D455 云台俯仰支架

    对于 Intel RealSense D455 或类似的 RGBD 摄像头,使用 Gimbal_Pitch_Holder_d455.stl。

  • 下载 3D 模型

    打开 XLeRobot 硬件目录并下载打印所需的 3D 模型。

  • 准备并切片模型

    在切片软件中自行摆放和定向模型并添加支撑;根据强度、效率和细节调整填充率与打印速度。

  • 打印机械臂底座

    使用 STL 文件和 PLA 耗材打印机械臂底座部件。

  • 打印颈部和头部

    使用 STL 文件和 PLA 耗材打印颈部和头部部件。

  • 打印轮式底座

    使用 STL 文件和 PLA 耗材打印轮式底座部件。

  • 下载并打印 STL 文件

    从文档链接下载 XLeRobot_0_4_0_extra.stl,并使用它制作所需的 3D 打印件。

  • 获取 IKEA 推车连接件模型

    从文档提供的链接获取连接 IKEA 推车的连接件 STL 文件。

  • 打印机器人零件

    按照3Dprint.md指南打印所需部件。

  • 打印机器人部件

    按照链接中的 3D 打印指南打印机器人部件。

  • 修改并打印连接器

    如果配合不正确,在切片软件中稍微调整连接器 3D 模型的 z 轴缩放,保持 xy 轴缩放不变,然后重新打印。

组装

  • 从零开始装配机器人

    从零开始预计需要 2–4 小时;若使用已装配的 SO100/SO101 机械臂则需要 1–2 小时。可参考 Wowrobo 官方装配视频和 Greg’s Tech 技巧。

  • 检查 SO101 机械臂

    如果已经拥有两个完成装配且电机已配置的 SO101 机械臂,则跳过本节。

  • 准备 Lekiwi 底板

    如果已有 Lekiwi 底座,请拆下电池、舵机安装座等。底板仅保留三个带轮子的已安装电机及其接线。

  • 选择顺序正确的底板

    不要选错底板,因为每块底板的部件安装顺序固定。

  • 翻转购物车进行装配

    将购物车翻过来,再进行后续底座装配。

  • 安装十二颗 M3 螺钉

    这个新硬件版本与 IKEA 购物车金属网兼容,十二颗 M3 螺钉应能轻松装入。

  • 组装顶部底座

    按照文档中的顶部底座装配图完成组装。

  • 组装机器人头部

    按照文档中的头部装配图完成头部组装。

  • 完成顶部底座布线

    完成顶部底座的全部接线和线缆整理,并在将顶部底座夹紧到 IKEA 购物车之前把 Raspberry Pi 放入盒中。

  • 放置电池并最后连接电源线

    放置电池。为保护电机控制板,最后连接电源电缆;插拔其他电缆时始终先断开电源电缆。

  • 将底座装入购物车

    在完成顶部底座的接线和线缆整理、并将 Raspberry Pi 放入盒中后,把顶部底座夹紧到 IKEA 购物车中。

  • 组装双轮版本

    按照装配图和官方装配视频组装双轮版本。

  • 用螺钉固定推车连接件

    使用所需的 M8×20 螺钉将连接件固定到 IKEA 推车。

  • 组装XLeRobot

    按照Assembly.md指南完成XLeRobot的组装。

  • 将垫圈装入 IKEA 推车

    将打印的垫圈插入 IKEA 推车,以获得最佳底座支撑。

  • 组装机器人

    按照链接中的组装指南组装机器人。

软件与固件

  • 安装 LeRobot

    按照官方安装指南安装 LeRobot。

  • 克隆 XLeRobot 仓库

    克隆该仓库,然后进入克隆下来的目录。

  • 安装共享模块

    安装包含 SO101 运动学辅助函数的共享模块。

  • 安装 3 全向轮底盘插件

    安装适用于 3 全向轮底盘的机器人插件。

  • 安装 2 轮差速底盘插件

    安装适用于 2 轮差速驱动底盘的机器人插件。

  • 安装麦克纳姆轮底盘插件

    安装适用于麦克纳姆轮底盘的机器人插件。

  • 安装 VR 遥操作插件

    安装 VR 遥操作插件。

  • 为树莓派取消注释主机与客户端

    如果基于树莓派构建,在 software/src/robots/ 下插件的 __init__.py 中取消注释 xlerobot_host 和 xlerobot_client。

  • 安装 LeRobot 插件

    将 `src/robots/` 和 `src/model/` 作为插件安装到 LeRobot 中。

  • 运行键盘关节控制

    使用键盘进行关节控制。控制代码应兼容 SO100 和 SO101,即使代码名称中仍保留 so100。

  • 运行键盘末端执行器控制

    使用自有的解析逆运动学,通过键盘控制末端执行器。

  • 运行双臂键盘末端控制

    在双臂配置中,使用自有的解析逆运动学,通过键盘控制末端执行器。

  • 熟悉基本开发环境

    至少花一天熟悉基本的Python、Ubuntu和GitHub。

  • 安装并运行机器人软件

    按照Software.md指南安装软件并让机器人运行。

  • 重现远程控制演示

    将一个机械臂连接到树莓派,另一个连接到桌面,以远程控制方式重现Demo 0.1.0。

  • 安装依赖

    在 XLeVR 目录中运行 requirements.txt 的依赖安装命令,无需执行 pip install -e。

  • 从其他目录运行脚本

    将 vr_monitor.py 复制到任意目录,并确保脚本顶部的 XLEVR_PATH 变量指向正确的 XLeVR 主目录,然后按前述方法安装依赖。

  • 安装并运行软件

    按照链接中的软件指南让机器人开始运动。

  • 授予 Linux 串口权限

    在 Linux 上,先运行 sudo chmod 666 /dev/ttyACM0;Windows 和 Mac 不需要这一步。

标定与测试

  • 使用 Bambot 配置电机

    官方 lerobot 代码库目前不支持机械臂之外的电机配置,因此改用 Bambot。

  • 测试底座与购物车配合

    将带连接器的 Lekiwi 底座放到购物车下方,确认其能提供足够压力,同时购物车的四个轮子仍能接触地面。

采数据与训练

  • 直接运行 VR 监视器

    从 XLeVR 目录运行 vr_monitor.py,在 VR 头显浏览器中打开终端显示的 HTTPS 地址,然后移动 VR 手柄,终端会打印实时控制数据。

  • 在代码中读取 VR 数据

    创建 VRMonitor 实例并调用 initialize(),再在事件循环或回调中使用 get_left_goal_nowait() 和 get_right_goal_nowait() 读取左右控制目标。返回的 ControlGoal 对象包含位置、方向等信息。

  • 检查 ControlGoal 数据字段

    ControlGoal 的主要字段包括 arm、mode、target_position、wrist_roll_deg、wrist_flex_deg、gripper_closed 和 metadata,可读取设备类型、控制模式、三维位置、手腕角度、夹爪状态和附加控制器信息。

  • 运行 YOLO 手部相机跟踪

    运行 `simple_so100_yolo_ee_control.py`,使用 YOLO 进行目标检测和分割,并通过手部相机进行实时跟踪。

用起来

  • 确认服务器正在运行且可访问

    打开用户界面前,先确认服务器正在运行并可访问。

  • 提供客户端开发服务器或生产构建

    为浏览器访问提供客户端开发服务器或生产构建。

  • 打开默认开发地址并检查仪表板

    打开默认开发地址 http://localhost:5173,确认仪表板能够加载。

  • 监控终端日志中的遥测和错误

    监控终端日志中的遥测、错误或重连问题,以便进行故障排除。

  • 添加可选外观升级件

    如果希望改善外观,可以将这些零件安装到 XLeRobot 上。

  • 在 LeRobot 命令中使用插件类型

    --robot.type=xlerobot / xlerobot_2wheels / xlerobot_mecanum 与 --teleop.type=xlerobot_vr 现在可用于任何标准 LeRobot CLI 命令,例如 lerobot-teleoperate、lerobot-record。

常见问题

  • 电机ID、扫描及固件升级导致机械臂无法正确配置 #85 #38 #70
  • 结构尺寸、轮子固定和舵机供电问题阻碍可靠组装 #45 #25 #105 #140
  • 仓库下载、说明命令和URDF文件缺失或无效 #30 #56 #131
  • 示例因模块缺失和仿真引用过期而无法运行 #89 #108 #80
  • YOLO示例无法正确跟踪物体或加载模型 #72 #76
  • 键盘、VR和网页控制均出现连接失败 #52 #87 #95
  • RealSense相机在设备测试时无法正常工作 #17
  • VR遥操作数据采集运行一段时间后突然崩溃 #119

数据集

物料

  • SO‑101 机械臂 2 条与 LeKiwi 风格底盘(项目基于 SO‑101、LeKiwi 与 Bambot)
  • IKEA 推车与电池(开发套件不含)
  • 头部 RGB 相机;可选双目或 RealSense 深度相机
  • 笔记本或树莓派作主控

工具

  • 3D 打印机
  • 工具清单官网未列

技能

  • Python、Ubuntu、Git 与 pip
  • 可选:MuJoCo 仿真与 VLA 训练

软件

  • LeRobot 系
  • 键盘、Xbox 手柄、Joy‑Con 与 Quest 3 遥操作
  • MuJoCo 仿真与 RL 环境

文档