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。
常见问题
数据集
物料
- 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 环境