让机器人跟着双手学
斯坦福、加州大学伯克利分校与Meta团队发表于RSS 2023的双臂遥操作及ACT模仿学习系统。本页锁定原版固定桌面ALOHA:两台WidowX主臂、两台ViperX从臂、四路相机,附原版采购表与打印装配图。ROS版本差异、材料缺口与独立复现证据范围均明确标注。
alan000
Robotics: Science and Systems (RSS) 2023
目标:先把固定桌面配置的机械臂、相机与打印件按编号分组。
1. 按 B01–B41 逐项清点:主控臂为两台 WidowX250,执行臂为两台 ViperX300;四台均为 6 自由度。
2. 清点 4 台相机,其中两台装在执行臂腕部、两台固定在框架上。
3. 逐件标记 25 个打印零件,并留存每台机械臂随箱提供的螺丝、垫圈和 T 形螺母,后续安装会复用。
4. Rotor/Rotor_arm 数量在总表与装配步骤之间有歧义;对照 STL 和左右装配图确认后再打印/采购。
5. 螺丝盒和型材包按包装单位采购;为清单中无链接的自备项和电源补件建立独立核对栏。
**检查**:四台臂、四台相机、25 个打印件及可复用紧固件均有清点记录;转子数量冲突未解决前不多做或少做零件。

目标:按原版模型打印受力件,先验证活动配合再进入组装。
1. 从原版文件下载 M01–M11 的 STL/STEP,记录文件版本和零件编号。
2. 按原教程使用 PLA、支撑和 40–80% 填充作为参考;增加外壁及顶/底层以加强受力件,温度按打印机和耗材规格标定。
3. 先打印滑块试件,去掉支撑和毛刺后装入夹爪导轨,手推检查全程顺畅。
4. 若卡滞,只做少量后处理并反复试配;不让电机强拉滑块。装机前检查所有受力打印件无裂纹。
**检查**:模型文件与编号对应,滑块在导轨内可顺畅滑动;受力件无裂纹或缺层。
[完整打印方向图](https://docs.google.com/document/d/12CG6rpxGDWrFup6TKJlERBrPEvHbLrQyN4ZI9gbEkKM/mobilebasic)
目标:在两台 WidowX 主控臂上安装可手动示教的手柄机构。
1. 先支撑机械臂并断开夹爪电源;拆下原夹爪时逐件标记螺丝、垫圈和安装位置。
2. 在两台主控臂安装 handle_lower 与 handle_upper;每侧按原图用 M2.5×10 螺栓和螺母固定。
3. 依序安装 lever、slider、rotor 与 rotor_arm;活动孔需自由转动,Rotor/Rotor_arm 数量按 STL 与两侧图核对。
4. 按原视频调整手指环长度并用热熔胶固定;安装电机轴前支撑机械臂,仅操作确认的 9 号夹爪电机并按教程设到 180°。
5. 其他关节保持支撑和正常保持力,不悬空断力。
**检查**:两侧手柄机构能自由活动,手指环不会滑脱;9 号夹爪电机身份确认,轴向与图一致,其他关节仍有支撑。

目标:固定左右导轨滑块,随后只释放对应夹爪电机的扭矩检查反驱。
1. 按原顺序用 M3×30 螺丝和螺母制作间隔/固定件,再复用 T 形螺母装入铝导轨。
2. 左右各装一组滑块;按 T 形螺母→滑块→滑块→T 形螺母的顺序穿入导轨。
3. 检查导轨和机械臂底座固定后,先用支撑承住机械臂,再只关闭对应夹爪电机扭矩。
4. 用手缓慢移动手柄,感受反驱是否顺畅;检查有无卡滞、刮擦和明显侧向晃动。
5. 严禁将整臂断扭矩或把失去保持力的机械臂悬空。
**检查**:导轨顺畅无卡点;单独释放夹爪电机后手柄可手动移动,其他关节仍保持受支撑状态。

目标:在 ViperX300 执行端装打印夹爪并加防滑层。
1. 先把导轨滑块装到左右执行臂,检查滑块与导轨配合顺畅。
2. 用原有长螺丝将 Finger1、Finger2 固定在每台 ViperX300;夹爪直边朝上,左右朝向不要倒置。
3. 阻力异常时拆下检查孔位和打印公差,不强拧螺丝。
4. 按原教程先裁约 1 cm 胶带贴指尖,再用约 10 cm 胶带包住夹爪;先包直边,再包另一侧并压实修边。
5. 可选全指包覆按 5 cm、3.5 cm、2 cm 分段,避免相邻接缝重叠。
**检查**:两台执行夹爪开合对称,滑块无卡滞,胶带边缘压实且不卷起、不影响导轨间隙。

目标:在执行臂末端安装相机,确保视场覆盖夹爪且线缆不限制腕部。
1. 在两台 Logitech C922x 上拆下底座,按原图将相机装入 cam_mount,并用 M3×4 螺丝固定。
2. 每台相机用 4 颗 M2.5×8 安装到对应执行臂腕部。
3. 沿机械臂布置 USB 线并留足关节活动余量,固定线缆使其远离齿轮、导轨和夹点。
4. 手动缓慢活动腕部和夹爪全行程,检查视场无遮挡、线缆不被拉紧。
**检查**:两台腕部相机稳固,夹爪及腕部全行程内画面覆盖任务区域,USB 线不夹入机构。

目标:先建稳框架并固定桌面,再安装四台机械臂。
1. 按原 CAD 识别长型材、100 cm 型材、15 cm 短梁及两类角码/T 形螺母;不要混用不同规格。
2. BOM 列 1220 mm 型材,而示意图标 120 cm;先按当前 CAD 核对切割长度和孔位,不把 20 mm 差值当作公差。
3. 按原定位图将 15 cm 短梁放在距桌缘 25 cm 处,水平横梁距桌面 80 cm;装配中先轻锁,再检查方正和净空。
4. 框架固定到桌面前确认桌体材质和承载;原表未给木螺丝规格,不能仅凭照片推定承载能力。
**检查**:型材长度和孔位已按 CAD 核实;框架方正、桌体连接牢固且不倾倒、不明显晃动。
[原版框架CAD查看器](https://a360.co/3kmDwfl)
目标:定位主控/执行臂底座和固定相机,建立稳定的任务中心。
1. 每台主控臂底座按原图用两处 M5×14 和 drop-in T 形螺母固定;每台执行臂用三处固定,其中一处安装在 15 cm 短梁。
2. 检查螺栓长度和铝型材咬合,避免触底或有效啮合不足;手动轻推底座确认无松动。
3. 用 15 cm×1 cm 白胶带标出工作区中心:两执行臂底座连线与桌面中线交点。
4. 将顶相机装到上横梁中部;前相机使用 cam_mount_2 和短梁。原文一处写 15 mm,BOM 和后文为 15 cm;安装前核对 CAD,未确认不切梁或钻孔。
5. 调两台固定相机,使画面覆盖任务区及两只执行夹爪,并记录序列号与位置。
**检查**:四台臂底座固定无晃动,工作中心标记清楚;四台相机均覆盖任务区,前相机梁长与 CAD 一致。

目标:降低主控臂自重和桌架晃动,同时检查电源与安全停止条件。
1. 在机械臂保持支撑时,用碳纤维管、橡皮筋和扎带逐步调整主控侧重力补偿;橡皮筋不作为唯一防坠措施。
2. 按钢索套件说明安装交叉钢索并张紧,检查压接端头牢固、钢索不碰活动关节。
3. 电源需配 1 台电源、4 条连接线及相应端子;市电端子和改线由合格人员按设备额定电压、电流、接地和绝缘要求核对。
4. 上电前确认电源输出、极性、接地、线缆应力释放和可快速断电方式;不按照片猜接线。
5. 清空机械臂运动范围和夹点附近人员后再进行后续上电。
**检查**:补偿件和钢索固定牢固、框架不明显晃动;电源接线由合格人员确认,急停/断电方式可触及。

目标:为四臂和四相机建立稳定设备身份,并按同一 ROS 版本配置。
1. 本路线使用仓库 README 的 Ubuntu 20.04 + ROS1 Noetic;硬件 Google 文档所写 ROS2 Humble 属另一软件路线,不混用。
2. 记录 ALOHA、ACT、Interbotix 的源码提交和依赖版本,按对应说明建立工作区、安装依赖并构建。
3. 四台机械臂分别直连 USB,不用 USB Hub 或延长线;四台相机可分接两个 Hub,每个 Hub 最多两台。
4. 按实际序列号绑定 ttyDXL_master_right、ttyDXL_master_left、ttyDXL_puppet_right、ttyDXL_puppet_left,以及 CAM_RIGHT_WRIST、CAM_LEFT_WRIST、CAM_LOW、CAM_HIGH;不复制他人序列号。
5. 按当前型号和官方配置用 Dynamixel Wizard 检查 Protocol 2.0、1 Mbps、ID 0–10;执行端 9 号夹爪电机 Current Limit 寄存器值为 200(不是 200 A)。
6. 机械臂无自动抱闸,断扭矩前必须支撑机械臂。
**检查**:四臂和四相机可稳定识别,序列号与左右/角色映射有记录;Protocol、波特率、ID 和寄存器设置与当前电机一致。
[官方软件与设备设置全文](https://github.com/tonyzhaozh/aloha)
目标:在安全姿态中验证控制映射,再录制和离线检查一段示教数据。
1. 将四臂放入官方 sleep 姿态,打开主控夹爪并清空工作台及夹点;确认周边无人。
2. 按原流程启动 `4arms_teleop.launch`,再分别启动左右 `one_side_teleop.py`。主控夹爪闭合会触发遥操作,操作者需先确认触发逻辑。
3. 先单侧低速、小幅验证左右映射、夹爪方向和限位,再测试双侧;异常时按停止流程结束并断电检查。
4. 遥操作程序本身不保存示教。运行 `python3 record_episodes.py --dataset_dir <数据目录> --episode_idx 0` 录制,再运行 `python3 visualize_episodes.py --dataset_dir <数据目录> --episode_idx 0` 离线检查。
5. 确认 HDF5 中图像、关节和动作时间同步;实机 replay 会真实驱动机械臂,运行前须再次清空活动范围。结束后按原 sleep 流程让四臂回稳,再断电。
**检查**:单侧/双侧方向和停止方式均确认;HDF5 与离线可视化能对应图像、关节和动作,机械臂处于安全姿态。
`teleop.pyteleop.py`
目标:先保存可复现硬件与示教记录,再单独设计算法评估。
1. 归档最终 BOM 差异、打印参数、框架尺寸、设备序列号、软件提交和依赖环境。
2. 保存四路相机画面、示教 HDF5、离线可视化视频、操作日志和安全检查记录。
3. 若后续训练 ACT,按官方算法仓库准备数据、训练环境和明确任务定义;首次上机策略保留可立即停止的操作员与限制范围。
4. 先设定成功判据和固定评测流程,再报告成功次数/总次数;记录本机实测结果及测试条件。分别确认模型文件、数据集和商业部件的许可。
**检查**:硬件、软件和数据版本可追溯;示教数据离线检查通过;任何实机策略测试都有预先定义的停止措施和评估标准。
[ACT源码与实验说明](https://github.com/tonyzhaozh/act)[原版演示视频与研究背景](https://tonyzhaozh.github.io/aloha/)