LeRobot实战：从SO100搭建到ACT策略复现全流程解析

1. SO100机械臂硬件搭建全攻略第一次接触LeRobot机械臂时我被SO100模块化设计惊艳到了。这种开箱即用的机械臂套件特别适合像我这样的机器人爱好者不需要从零开始设计机械结构又能完整体验机器人学习全流程。不过实际组装过程中还是踩了不少坑这里把经验完整分享给大家。硬件准备阶段最容易出问题的就是3D打印件。虽然官方提供了STL文件但不同打印机的公差会导致装配困难。我强烈建议准备以下工具包小型锉刀套装处理打印件毛边M3规格的各种长度螺丝原装配件可能不够带磁性的精密螺丝刀狭小空间操作必备数字游标卡尺验证关键尺寸电机配置是第一个技术难点。在Windows系统下需要先运行find_motors_bus_port.py定位串口。这里有个隐藏技巧断开USB线后一定要等待5秒再敲空格否则可能漏检设备。配置六个舵机时波特率必须统一设为1000000ID则按1-6顺序递增。如果遇到电机抖动问题很可能是电源功率不足建议使用12V/5A以上的稳压电源。主从臂安装有个关键差异点主臂的顶部齿轮需要拆除。这是因为遥操作模式下主臂不需要动力输出拆除后能减少齿轮磨损。安装时切记先用手转动各关节测试顺畅度我遇到过谐波减速器卡死的情况后来发现是轴向预紧力没调好。2. 机械臂配准与遥操作配置完成硬件组装后配准环节直接决定后续操作精度。校准脚本会引导机械臂完成三个关键位姿Zero Position所有关节归零Rotated Position各轴90度位置Rest Position工作待机姿态实测发现最容易出错的是舵机朝向。SO100的第六轴舵机安装方向与其他轴相反如果校准时报Joint limit exceeded错误大概率是这个问题。建议准备手机水平仪APP确保每个关节的物理角度与软件显示一致。遥操作测试时有个实用技巧先用--control.typetest模式检查各轴响应。这个模式会依次驱动单个关节运动比直接全轴操作更容易发现问题。我遇到过主从臂运动方向相反的情况后来发现是config.py里的invert_axis参数需要调整。摄像头配置直接影响后续数据集质量。经过多次测试推荐双摄像头布局方案摄像头A45度俯视角覆盖工作台全域摄像头B侧视特写聚焦夹爪动作 在config.py中需要正确设置camera_resolution和fps建议先用OpenCV测试帧率避免后续录制掉帧。3. 高效数据集采集实战数据集采集是机器人学习最耗时的环节。经过多次迭代我总结出高效录制三原则任务描述要具体如抓取红色乐高块放入蓝色盒子环境背景保持一致性包含10%的失败操作样本Hugging Face登录环节容易遇到SSL证书问题。如果huggingface-cli报错可以尝试先执行git config --global http.sslVerify false录制命令中的几个关键参数需要特别注意warmup_time_s建议设为5秒以上避免机械臂刚启动时的抖动reset_time_s根据任务复杂度调整简单抓取30秒足够single_task描述要包含物体特征和动作目标遇到视频编码问题时除了安装x264还需要检查FFmpeg环境变量。在conda环境下建议用conda install -c conda-forge ffmpeg4.3.14. ACT策略训练技巧在AutoDL服务器训练时三个配置技巧能大幅提升效率开启学术加速后在~/.bashrc添加alias hfHF_ENDPOINThttps://hf-mirror.com使用wandb监控时设置--wandb.tagsso100方便分类训练中断后添加--resume_from_checkpointlast继续训练ACT策略的超参数调优很关键推荐初始配置policy: learning_rate: 3e-4 num_epochs: 200 batch_size: 32 hidden_dim: 256 mlp_depth: 3训练过程常见问题排查Loss不下降检查数据集是否包含足够多的动作变化GPU内存不足减小batch_size或降低图像分辨率过拟合添加weight_decay0.01正则化5. 策略评估与部署要点本地评估时最容易忽略的是环境一致性。建议保持与训练时相同的照明条件使用相同型号的摄像头固定机械臂底座防止晃动评估命令中的几个实用参数--control.headlesstrue无图像模式提升性能--control.debug_plotstrue实时显示决策热图--control.max_retries3自动重试失败任务遇到策略执行卡顿时可以尝试量化模型from transformers import AutoModel model AutoModel.from_pretrained(your_model).to(cuda) model torch.quantization.quantize_dynamic(model, {torch.nn.Linear}, dtypetorch.qint8)最后提醒大家定期检查机械臂的螺丝紧固情况和线材磨损度我在连续运行两周后发现第4轴编码器线有断裂迹象及时更换避免了数据漂移问题。