AlohaMini(AlohaMini2 / AlohaMini 1) 复刻全流程
AlohaMini(AlohaMini2 / AlohaMini 1) 从采购、打印、组装到装软件、标定和训练的 143 个步骤,附物料表、购买链接与官方出处。
作者估算:README 列主要部件约 950 美元(不含主臂,机架约 6 kg 耗材自打印);BOM.md 全套(底盘、两条从臂、两条主臂与紧固件)自打印合计 7,548 元 / 约 1,097 美元,不含约 5 kg 耗材,也不含夹具、烙铁与螺丝刀等常用工具。1 代自打印约 600 美元
物料 · Bill of Materials (BOM)
| 零件 | 数量 | US |
|---|---|---|
| Servo — standard | 11 | USD 16 |
| Servo — high-torque | 7 | USD 50 |
| Bus servo controllers | 2 | USD 5 |
| Compute | 1 | USD 93 |
| Cameras | 5 | USD 17 |
| Omni wheels | 3 | USD 40 |
| Battery 12V | 2 | USD 16 |
| Frame | — |
物料 · Mobile base
| 零件 | 数量 | US | CN |
|---|---|---|---|
| Servo motor | 4 | USD 13.89 | CNY 110 |
| Omni wheel | 3 | USD 47 | CNY 135 |
| USB camera | 3 | CNY 125 | |
| (optional) Bearing | 3 | CNY 6 | |
| Bearing | 8 | CNY 3 | |
| M2×12 Phillips screw | 12 | ||
| M3×12 hex socket screw | 36 | ||
| M3×18 hex socket screw | 12 | ||
| M3×30 hex socket screw | 8 | ||
| M3 hex nut | 8 | ||
| M3x5x4 heat-set insert | 36 | CNY 5 | |
| M4×12 hex socket screw | 20 | ||
| M4x6x5 heat-set insert | 12 | CNY 4 | |
| Adhesive | 1 | CNY 12 | |
| Servo extension cable | 2 | CNY 3 | |
| Battery | 2 | USD 43 | CNY 130 |
| USB Type-C cable | 1 | USD 10 | CNY 20 |
| Waveshare Bus Servo Controller | 1 | USD 13 | CNY 27 |
| 3D-printed parts | ~4 kg filament |
采购
- 准备移动底盘和两个从动臂
准备移动底盘和两个从动臂;从动臂直接沿用 SO-ARM100 设计。
- 准备主机端遥控设备
主机端使用 PC 工作站和主臂;也可以使用 VR 控制器等其他设备。初学者建议使用主臂进行遥操作。
- 添加独立运行模式组件
如需通过 Wi‑Fi 无线独立运行底盘,添加该表中的独立运行模式组件。
- 采购组件并打印零件
按照 BOM 与 3D 打印文档采购组件并打印零件。
- 查看物料清单并采购零件
查看物料清单,并按照文档所列组件采购零件。
打印与加工
- 打印轴承盖
打印 3 个 OB_Chassis_Bearing_Cover。
- 打印舵机安装座
打印 3 个 OB_Chassis_Servo_Mount。
- 打印底盘侧板
打印 3 个 OB_Chassis_Side_Panel。
- 打印轮轴连接件
打印 3 个 OB_Chassis_Wheel_Axle_Connector。
- 打印车轮护罩
打印 3 个 OB_Chassis_Wheel_Guard。
- 打印顶部摄像头后盖
打印 2 个 OB_Top_Camera_Back_Cover。
- 打印轴套
打印 3 个 OB_Chassis_Shaft_Sleeve_12_24。
- 打印底盘定位销
打印 3 个 O_Chassis_Dowel_Pin_12_37。
- 打印所有其他文件
列表中的所有其他文件各打印 1 个,包括升降机构。
- 用标准三维打印机打印其余零件
除底盘外,所有其他零件(包括升降机构)都可使用标准三维打印机打印。
- 选择足够大的底盘打印机
底盘需要至少 385 × 345 × 64 mm 的打印空间,建议选择约 400 × 360 × 100 mm 或更大的设备。
- 必要时外包底盘打印
由于底盘尺寸较大,可能需要将底盘打印工作外包。
- 打印从臂 D 文件
打印全部“D_*.stl”文件,每个数量为 x2。
- 打印从臂 F 文件
打印全部“F_*.stl”文件,每个数量为 x2。
- 参考打印说明
按照链接的 SO-ARM100 项目 README 进行详细打印。
- 打印主臂 D 文件
打印全部“D_*.stl”文件,每个数量为 x2。
- 打印主臂 L 文件
打印全部“L_*.stl”文件,每个数量为 x2。
- 参考打印说明
按照链接的 SO-ARM100 项目 README 进行详细打印。
- 打印硬件 STL 文件
`/hardware/` 目录提供可打印的 STL 文件。
- 打印升降塔零件
按顺序准备升降塔零件:O_POST4_Connector_Base.stl、O_Main_Assembly_Post4.stl、OB_Main_Assembly_Post3.stl、OB_Main_Assembly_Post2.stl、OB_Main_Assembly_Post1.stl。
- 打印全部结构件
使用 Bambu P2S 打印所有结构件,约需 6 千克耗材。
组装
- 连接舵机线缆
使用随附的20cm舵机线缆连接舵机8、9和10,并使用90cm舵机线缆连接舵机10和11。
- 安装舵机支架热熔螺母
使用烙铁将M3热熔螺母安装到舵机支架中。
- 固定舵机
使用舵机随附的小螺钉固定舵机。
- 安装轮轴连接器
安装轮轴连接器。如果连接器无法装入,可将其打磨以改善配合。连接器安装完成后,如果松动,可用螺钉紧固或使用环氧树脂粘接;如果已经足够紧,则不需要额外处理。
- 将舵机安装到底盘板
按照图片中所示的舵机顺序,将舵机安装到底盘板上。
- 用螺钉固定舵机到底盘
使用M3x14螺钉将舵机固定到底盘板上。
- 安装全向轮
使用M3x18螺钉将全向轮安装到舵机连接器上。
- 安装底盘轴承
可选地安装底盘轴承。将12x18x4轴承插入定位销和轴套中,再将M4热熔螺母安装到Chassis_Bearing_Cover中,最后使用M4x12螺钉固定。
- 安装侧板热熔螺母
将M3热熔螺母安装到侧板中。
- 组装主支柱
像搭建积木一样组装主支柱,总共有4根。使用环氧树脂或双面胶将部件粘合在一起。
- 安装升降轴
安装升降轴。根据BOM清单准备材料。
- 固定齿轮
使用舵机随附的螺钉固定齿轮。
- 将齿轮装入轴舵机座
将齿轮插入Axis_Servo_Mount中。
- 固定轴支架
使用舵机随附的M3x6螺钉将Axis_Bracket固定到舵机上。
- 安装T形支架
安装T形支架。
- 用环氧树脂固定
使用环氧树脂固定T形支架。
- 将升降轴滑入T形支架
将升降轴滑入T形支架。
- 安装顶部和后置摄像头
安装顶部和后置摄像头,并从摄像头后盖上拆下两颗螺丝。
- 装回摄像头后盖
使用M2x12螺丝装回后盖,并将打印件夹在后盖与摄像头之间。
- 布置摄像头线缆
将摄像头线缆穿过打印件内部的线槽。
- 固定显示屏
使用随附的M3舵机螺丝,将显示屏固定到打印件上。
- 安装显示屏到主柱
将显示屏滑入主柱后侧的插槽。
- 安装前置摄像头
按照与顶部摄像头相同的方法安装前置摄像头,将其滑入槽内;若打印件有毛刺,则打磨平整以确保顺畅配合。
- 布置主柱后侧线缆
将USB Type-C数据线和DC电源线穿过主柱后侧的孔。
- 完成移动底座组装
移动底座组装完成。
- 组装主臂和从臂
按照SO-101组装指南组装主臂和从臂。
- 固定机械臂
使用四颗M3x30内六角螺丝和四颗M3螺母,将机械臂固定在T形支架两侧。
- 连接左臂舵机线缆
将来自舵机#11的90厘米舵机线缆连接到左臂Waveshare控制板的另一个端口。
- 安装降压转换器
将12V转5V降压转换器安装到底座上,并将其连接到树莓派。
- 连接锂电池供电
将12V锂电池连接到降压转换器以供电。
- 连接直流分线器
将1转2直流分线线缆的公插头连接到两根直流延长线的母接头。
- 连接第二块锂电池
将第二块12V锂电池连接到1转2直流分线线缆的母接头。
- 完成全部组装
从臂和移动底座的组装全部完成。
- 准备跟随臂和主臂
在组装移动底座前,按照 AM-ARM200 组装指南准备跟随臂和主臂。
- 清除底座打印支撑
清除底座零件上的所有打印支撑,重点处理轮舱、线缆通道和定位销槽。
- 在接合面涂环氧胶
在底座零件的接合面上涂环氧胶。
- 安装底座锁定楔
将 `OB_Chassis_Locking_Wedge.stl` 插入锁定销槽。三个底座锁定销为锥形,必须按正确方向安装,使组装后塔座能够紧密楔紧。
- 连接底座框架
在 `OB_Chassis_Frame_Joiner.stl` 连接件上涂环氧胶,然后压紧底座零件,直到完全就位。
- 安装三个轮舵机
将三个轮舵机安装到底座中,并在分配舵机 ID 后按图示方向放置。
- 连接并固定轮舵机
依次连接舵机 8 到 9、9 到 10、10 到 11。由于舵机 10 和 11 相距较远,至少使用 90 cm 的三针舵机线,推荐使用 140 cm 线缆,并用舵机附带螺钉固定。
软件与固件
- 将 AlohaMini 接入现有 LeRobot
将 `alohamini/software` 中的文件复制到现有的 LeRobot 工作区,然后按照 `lerobot_alohamini` 仓库中的配置和命令行示例操作。
- 克隆集成的 LeRobot 与 AlohaMini 仓库
初学者可直接克隆集成的 `lerobot_alohamini` 仓库。该仓库将 LeRobot 和 AlohaMini 捆绑在一起,无需手动复制文件或配置路径。
- 分配舵机ID
- 设置软件并实现遥操作
按照软件指南安装、连接并控制机器人。
- 获取 lerobot_alohamini
克隆 lerobot_alohamini 仓库,安装其依赖,并从仓库根目录运行命令。
- 安装软件并连接遥控
按照软件指南安装软件,连接机器人,并通过遥控进行控制。
- 克隆并安装 lerobot_alohamini
克隆并安装 `lerobot_alohamini` 仓库。
- 配置独立检出测试环境
在 PC 和 Pi 两端都设置 PYTHONPATH,并确认导入的是正在测试的检出,而不是另一个可编辑安装。
- 应用 Pi0.5 数据变换
先应用水平和垂直图像翻转,再使用配置的 robot_dof 将机器人动作对齐到 Pi0.5 动作空间。根据模型配置和 default_prompt 创建模型变换。
- 验证 18 项增量动作掩码
delta_action_mask 必须正好包含 18 个值。启用增量动作时,使用该掩码将输入转换为 DeltaActions,并将输出转换为 AbsoluteActions。
标定与测试
- 逐个查找设备端口
每次只连接一个设备,然后查找它对应的端口。
- 配置随动臂端口
在 Raspberry Pi 上编辑 src/lerobot/robots/alohamini/config_alohamini.py,将左总线端口写入 left_port,右总线端口写入 right_port。
- 设置主臂固定别名
PC 脚本使用 /dev/am_arm_leader_left 和 /dev/am_arm_leader_right 作为主臂别名;按照 commands.md 的 persistent-arm-ports 部分设置对应的 udev 别名。
- 统一脚本设备路径
如果使用不同的设备路径,请在 calibrate_bi.py、teleoperate_bi.py 和 record_bi.py 中保持路径一致。
- 确认整机预设端口
如果购买的是完整的 AlohaMini,Raspberry Pi 上的随动臂端口已通过 udev 规则固定,无需再次操作。
- 测试评估终止条件
验证 Host 重启或另一命令所有者接管时会结束评估。心跳命令不能绕过 Host 监视狗。
- 启动主机遥操作与评估
使用现有环境、机器人模型和校准配置启动 Host、遥操作和评估。
- 按顺序执行机器人恢复测试
使用受支持的机械臂和畅通的工作区,先检查普通遥操作,再测试慢速推理、正常停止和重连。硬件时序与恢复行为必须在机器人上验证,模拟测试不能证明这些行为。
- 验证缺失图像警告
相机警告遵循 Host 的已启用相机列表,并且每个缺失图像回合只出现一次。
- 核对相机警告触发条件
仅状态响应不会触发缺失图像警告。旧版 Host 没有相机元数据时使用客户端配置;缓存和占位图像不会获得新的采集时间戳。
- 安装前设置舵机 ID
安装舵机前先分配 ID,并且一次只配置一个舵机以避免 ID 冲突。
- 配置舵机 ID
从仓库根目录运行示例命令,将 ID 1 改为 ID 8,并使用 `/dev/ttyACM0` 端口。
- 使用 FD 调试工具
Use the Feetech FD Debug Tool through the Waveshare bus servo controller with baud rate `1000000`. Scan the servo, write the target ID, then disconnect it before configuring the next servo.
- 运行底盘首次测试
底盘组装完成后,运行 `lerobot_alohamini` 仓库中的调试命令,直接驱动底盘进行首次测试。
- 测试轮式驱动
在 /dev/ttyACM0 端口运行 W/S/A/D 驱动测试。
- 测试升降轴
在 /dev/ttyACM0 端口运行 U/J 升降测试。
- 配置机器人和端口
按照 `lerobot_alohamini` 中的说明配置机器人和端口。
采数据与训练
- 验证阻塞推理状态刷新
阻塞式推理在执行前刷新 Host 状态。仅释放监视狗不会重置推理,新命令使用当前控制纪元。
- 测试关节保持与恢复
活动的关节保持会暂停评估;释放后清除排队的预测,然后无需按 Enter 即可恢复。
- 验证关节保护事件清理
关节保护事件解决后,也要清除旧预测。
- 核对暂停与评估帧记录
暂停时间计入回合的墙钟时长。缓存观测不会作为新的评估帧保存。
- 确认录制前条件
录制前确认 Pi 主机已按 §5 运行。将 `<Pi_IP>` 替换为 Raspberry Pi 的 IP 地址,并确保 `--robot.robot_model` 与 Pi 主机上运行的模型匹配。
- 设置主臂与数据存储选项
将 `--teleop.arm_profile` 设置为 leader arm 硬件配置,而不是 follower robot。录制默认打印本地数据集路径并上传至 Hugging Face Hub;添加 `--dataset.push_to_hub=false` 可仅保留本地数据,添加 `--dataset.root /path/to/dataset` 可指定或恢复本地目录。
- 创建 AlohaMini 1 新数据集
运行 `record_bi.py`,创建 repository ID 为 `$HF_USER/so100_bi_test` 的数据集,录制 1 个时长 45 秒的 `pickup1` episode,帧率为 30 fps,重置时间为 8 秒。
- 恢复现有 AlohaMini 1 数据集
使用与新数据集相同的配置运行 `record_bi.py`,并添加 `--resume` 以恢复现有数据集。
- 创建新数据集
运行 record_bi.py 创建名为 $HF_USER/am2_bi_test 的数据集,录制 1 个 30 FPS、45 秒的任务片段,任务名为 pickup1,并使用 AM-ARM leader 6-DoF 配置。
- 恢复现有数据集
使用相同的录制参数运行 record_bi.py,并添加 --resume 以向现有数据集继续添加数据。
- 重放数据集
运行 replay_bi.py,重放 $HF_USER/am2_bi_test 数据集的第 0 个 episode,并连接 Pi 上的 alohamini2 机器人。如果数据集不在 $HF_LEROBOT_HOME/$HF_USER/am2_bi_test 下,添加 --dataset.root /path/to/am2_bi_test。
- 可视化数据集
运行 lerobot-dataset-viz,显示 $HF_USER/am2_bi_test 数据集的 episode 0,并显示压缩图像。
- 本地训练 ACT 策略
运行 lerobot-train,在 $HF_USER/am2_bi_test 数据集上训练 act 策略,使用 CUDA 设备,输出到 outputs/train/act_your_dataset1,关闭 wandb,并使用 pyav 视频后端。
- 使用云端 GPU
可使用 AutoDL、Lambda Labs 或 Vast.ai 等任意云端 GPU 提供商。按与本地相同的方式配置环境并运行相同的训练命令,然后复制回检查点供评估。
- 启动 Pi 并选择模型
确保 Pi 主机已运行,然后从 PC 执行推理。`--robot.robot_model` 必须匹配 Pi 上的模型:`alohamini1` 为 SO-ARM 5-DoF、16 维状态,`alohamini2` 或 `alohamini2pro` 为 AM-ARM 6-DoF、18 维状态。
- 运行 ACT 同步评估
使用 `evaluate_bi.py` 对 ACT 执行 3 个回合、每回合 45 秒的评估,帧率为 20。插值倍数为 3,因此首次动作后控制循环以 60 Hz 运行,并在策略动作之间进行线性插值。
- 运行 SmolVLA RTC 评估
使用 RTC 异步运行策略推理,并在机器人执行排队动作时刷新部分动作块。执行时域设为 10,最大引导权重为 10.0,队列阈值为 30,插值倍数为 1。
- 检查评估输出配置
两个示例都加载本地检查点,并将评估数据集保存在本地而不上传。运行前设置 `HF_USER` 或替换用户名,确保 `--policy.path` 存在且包含完整预训练模型,并为每次评估使用本地输出尚不存在的全新 `--dataset.repo_id`。
- 运行遥操作、数据采集和评估
从 `lerobot_alohamini` 仓库运行遥操作、数据采集和评估。
- 配置 AlohaMini2Pro 训练数据
创建名为 alohamini2pro 的 TrainConfig,使用 Pi0Config(pi05=True, action_horizon=10)。配置 LeRobotAlohaMiniDataConfig 从 /path/to/your/dataset_root 加载数据,启用任务提示和 default_prompt,并将 robot_dof 与 dataset_action_dim 设为 18。
- 映射 AlohaMini 观测和动作
将 cam_high、cam_left_wrist 和 cam_right_wrist 分别映射到 chest、wrist_left 和 wrist_right 图像,将状态映射到 observation.state,将动作映射到 action。加入 prompt 参数,否则模型训练不会包含任务描述。
- 设置原生 18 维增量动作
启用 use_delta_actions,并为两个机械臂各设置六个增量动作关节,同时将夹爪、底座和升降轴保持为绝对动作。
- 设置数据集资源和检查点权重
通过 assets_dir 和 asset_id 设置数据集路径,这两个值共同形成的路径等同于 repo_id。使用 CheckpointWeightLoader 从 gs://openpi-assets/checkpoints/pi05_base/params 加载权重。
- 配置 pi0.5 微调
将训练步数设为 50000,批量大小设为 4,工作进程数设为 2,并关闭 wandb。
- 选择微调权重
使用 pi0.5_base 权重进行微调,并按实际情况修改权重路径。
- 计算数据归一化统计
开始微调前,按照 openpi 的要求运行 scripts/compute_norm_stats.py,计算数据归一化统计。
- 启动远程策略服务器
在端口 8000 启动 HTTP 策略服务器,使用 pi05_test2 配置和指定的权重路径,并通过 --default_prompt 设置默认提示词。
- 启动 AlohaMini 主机
启动 AlohaMini 的 lekiwi_host,并使用 so-arm-5dof 机械臂配置。
- 评估 16 自由度机器人
以 remote_http 模式运行本地接收器 evaluate_bi.py,连接本机策略服务器,并将机器人自由度设为 16。
- 评估 18 自由度机器人
对于 18 自由度机器人,以 remote_http 模式运行 evaluate_bi.py,连接本机策略服务器,并将机器人自由度设为 18。
用起来
- 从电脑控制底盘
运行 wheels.py 和 axis.py,并指定 /dev/ttyACM0 端口。使用 W/S/A/D 驱动底盘,使用 U/J 升起或降低升降机构,无需在机器人上安装单板计算机。
常见问题
物料
- Feetech STS3215 12V(1/345)×11:三个轮子与两条从臂的腕部关节和夹爪
- Feetech STS3095 12V(95 kg·cm)×7:升降轴 1 个,两条从臂的肩、肘关节各 3 个
- 主臂:STS3215 7.4V(1/147)×14、Waveshare 驱动板 ×2、5V 电源
- 树莓派 5(2 GB)、32 GB microSD、12V→5V 5A 降压模块;12V 11,200 mAh 锂电池 ×2(一块供双臂,一块经降压供树莓派)
- 5 个 H65V1 720p USB 摄像头(2.4 mm):前、后、胸前与两只手腕
- 127 mm 全向轮 ×3、Waveshare 舵机驱动板、升降导轨轴承 4×13×5 mm ×8 与 12×18×4 mm 轴承 ×8、20×40 铝型材与 Φ12 钢销(可用打印件替代,但强度明显下降)
- 3D 打印件:PLA、PETG 或 ABS,按拓竹 P2S 尺寸设计;承重件建议 6 圈墙
工具
- 3D 打印机(拓竹 P2S 级;1 代需 380 mm 以上打印平台)
- 环氧胶(Loctite E‑120HP)粘接底盘与升降塔
- 桌钳、烙铁与螺丝刀套装(物料表称常用工具未列出)
- 一台 PC 作客户端接主臂;训练用 CUDA GPU,本地没有可改用云 GPU
技能
- 舵机 ID 设置(lerobot_alohamini 脚本或飞特 FD 调试工具,波特率 1,000,000)
- Linux、SSH、udev 端口别名与局域网配置
- LeRobot 校准、遥操作、录制与训练(ACT、SmolVLA);进阶:OpenPI 的 π0.5 微调
软件
- lerobot_alohamini v0.6.0(2026‑07‑12,已合并 LeRobot 0.6):树莓派主机 + PC 客户端,校准、遥操作、录制、训练与评估
- 主机 50 Hz 控制与看门狗,按舵机电流做堵转保护
- AlohaMini2 / 2 Pro URDF;1 代 ROS 包(RViz 与 Gazebo)
- examples/pi0.5_openpi:OpenPI π0.5 微调与部署