LeRobot SO-101协作机械臂完整搭建教程12个舵机如何变成一双听话的手【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobot想象一下这个画面你把左边的机械臂抬起来右边那支一模一样的臂几乎同时跟着抬起来动作丝滑得像镜子里的倒影。这不是遥控而是 LeRobot 开源框架里最经典的SO-101 协作机械臂玩法——一支领袖臂负责示教一支跟随臂负责复刻再靠端到端学习让跟随臂最终学会自己干活。如果你的困扰是机械臂项目要么太贵、要么全是工业黑话、要么装完就卡通讯——那这套方案正好对症。SO-101 的 BOM物料清单对新手非常友好核心就是 12 个 Feetech STS3215 舵机 2 块 USB 转串口控制器板 3D 打印件而 LeRobot 把找端口、设 ID、校准、录数据、训练、部署全做成了命令行工具你只需要跟着敲。学完这篇你能独立搭出一套双臂协作系统并跑通遥操作 → 录数据集 → 训练策略 → 自主执行的完整闭环。SO 系列机械臂的遥操作实录领袖臂一动跟随臂同步复现先看懂这套协作机械臂的分工很多人第一次看到 SO-101 会懵为什么同一台机器要买两支其实设计思路很清晰角色代号职责关键设计领袖臂so101_leader你用手直接掰动它输出示教轨迹不同关节用不同减速比省力好抓握跟随臂so101_follower精确复刻领袖臂的动作后续用于训练与执行6 个关节统一 1/345 减速比精度优先软件中枢LeRobot端口发现、舵机配置、校准、录数据、训练、rollout一条命令搞定一个环节这个分工带来的直接收益是你在教机器在看。后续把跟随臂的轨迹录成数据集喂给神经网络策略学完就能脱离你的手动操作这就是端到端学习的完整链路。下图是整个系统的架构视角可以感受一下感知 → 策略 → 执行的全貌LeRobot 端到端学习架构从视觉语言理解到机械臂动作执行动手前的准备清单硬件清单速览类别规格数量备注舵机Feetech STS3215数字总线舵机12双臂各 6 个领袖臂需按文档更换不同减速比的齿轮控制板USB 转串口MotorBus舵机总线板2每支臂一块电源12V/5A 直流2一臂一个供电不稳是多数灵异故障的源头结构件3D 打印件 M2/M3 螺丝1 套建议按 SO-ARM100 官方 BOM 采购与打印可选USB 摄像头2想录视觉数据、训练 VLA 策略时需要提醒领袖臂 6 个关节的齿轮比并不相同Base/Shoulder Pan 用 1/191Shoulder Lift 用 1/345Elbow 用 1/191Wrist Flex/Roll 与 Gripper 用 1/147采购时别图省事全买同一种。细节可对照官方文档 docs/source/so101.mdx。软件环境建一个独立虚拟环境conda / venv避免和其他项目打架。安装 LeRobotSO 系列机械臂需要额外带上 Feetech 舵机 SDKgit clone https://gitcode.com/GitHub_Trending/le/lerobot cd lerobot pip install -e .[feetech]装完后lerobot-find-port等命令能直接用就说明环境 OK 了。四步落地从零件到会动的手第一步组装结构件按基座 → 肩 → 肘 → 腕 → 夹爪的顺序装 6 个关节。三个容易翻车的细节3D 打印件的支撑残留要清干净关节轴承位必要时用细砂纸轻磨公差大就会晃。舵机 horn输出轴先用 M3x6 螺丝固定好再装电机省得回头拆装。SO-100/SO-101 的电机接线口装完结构后就不好够到了建议先给每个电机接好 3 针线再装官方文档特意强调了这点。第二步找端口 批量配置舵机通讯问题十有八九出在电脑根本没找到你的板子。别慌LeRobot 给了个傻瓜式工具lerobot-find-port它会让你依次拔掉、插上每条臂的 USB 线自动对比前后端口变化直接告诉你哪根线对应哪支臂Linux 下若提示无权限可先sudo chmod 666 /dev/ttyACM*。拿到端口号后给每支臂的 12 个舵机写 ID 和波特率# 跟随臂 lerobot-setup-motors --robot.typeso101_follower --robot.port/dev/ttyACM0 # 领袖臂 lerobot-setup-motors --teleop.typeso101_leader --teleop.port/dev/ttyACM1脚本会交互式地提示你现在只接 gripper 电机 → 回车 → 再只接 wrist_roll 电机……一次一个全部走完 ID 就写进舵机 EEPROM 了这一步一辈子做一次。这里有个新手必踩的坑舵机出厂默认 ID 都是 1如果不逐个设置总线上就会撞号表现就是有的关节动、有的不动像中邪一样。第三步校准让两支臂说同一种语言校准的目的让领袖臂和跟随臂在相同物理姿态下读出相同的角度值。这一步决定了遥操作的同步精度也决定了在一台机器上训的策略能不能直接用到另一台机器上。lerobot-calibrate \ --robot.typeso101_follower \ --robot.port/dev/ttyACM0 \ --robot.idmy_follower_arm操作流程很直白先把所有关节摆到量程中间回车然后逐个关节推到正极限、再推到负极限。领袖臂同理把参数换成--teleop.typeso101_leader。LeRobot 框架下的机械臂控制系统运行效果小抄ID 要和之前 setup/calibrate 保持一致这是 LeRobot 定位校准文件的方式。所有命令的完整参数可以翻 docs/source/cheat-sheet.mdx相当于随身的命令速查表。第四步遥操作 → 录数据 → 训练 → 自主执行前四步做完你的协作机械臂已经能照抄作业了现在让它学会作业录数据集lerobot-record启动后用键盘操作——→保存本集进入下一集←删掉重录ESC结束。给任务起一句自然语言指令如 put the red brick in a bowl一般录 20~30 集起步。训练策略lerobot-train指定数据集和策略类型act/diffusion/pi05等本地有 GPU 就--policy.devicecuda没有就交给--job.target云端跑。自主执行lerobot-rollout加载训好的策略跟随臂不再看领袖臂脸色摄像头 策略直接驱动它完成任务。完整的命令参数含双摄像头配置、深度流录制、视频编码参数都在 cheat-sheet 里照着抄改端口号就行。排障手册三个最常炸的环节1. 端口识别不到先确认你的 USB 线是数据线而不是只充电线换根试试最省事。Waveshare 控制板注意跳线要切到BUSB通道。Linux 权限问题用上面的chmod 666解决。2. 某个关节瘫痪或不响应90% 是 ID 没设对或设重了重跑一遍lerobot-setup-motors。剩下 10% 查三根线电源线、USB 线、板到电机的 3 针线每按一次 Enter 前都摸一遍接头。3. 校准后两支臂动作对不上重新校准时确认关节真的推到了机械极限差一点的角度会累积成肉眼可见的错位。校准文件按id归档检查 record/calibrate 用的id是否一致。进阶玩法装好只是起点多任务与多臂LeRobot 的multi_dataset支持把多个数据集合并训练仓库里还有 Unitree G1、双臂bi_ 系列等更复杂的机械体支持进阶可以看 src/lerobot/robots/ 目录。视觉语言策略接上摄像头后你可以尝试smolvla、pi05这类 VLA 策略让机械臂听懂把红色积木放进透明盒子这种话示例脚本在 examples/ 下。异步推理推理慢跟不上控制频率async_inference模块把策略放到服务器跑机器人端只发收观测延迟体验明显改善文档见 docs/source/async.mdx。自检小习惯每次改完硬件跑一遍lerobot-find-cameras和一次短 teleop花两分钟排除 90% 的低级问题。下一步就现在如果你手上已经有舵机和打印件按装结构 → find-port → setup-motors → calibrate的顺序走今晚就能让两支臂互相照镜子。遇到卡壳的地方先翻 docs/source/so101.mdx 和 docs/source/cheat-sheet.mdx再回来看看排障那一节——机器人调试本来就是试一次、错一次、通一次的过程。当你第一次看到跟随臂不靠你的手、自己把积木放进碗里的瞬间你会明白端到端机器人学习到底在说什么。去搭你的第一支 SO-101 吧 【免费下载链接】lerobot LeRobot: Making AI for Robotics more accessible with end-to-end learning项目地址: https://gitcode.com/GitHub_Trending/le/lerobot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考