正在连接信源…

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 — standard11USD 16
Servo — high-torque7USD 50
Bus servo controllers2USD 5
Compute1USD 93
Cameras5USD 17
Omni wheels3USD 40
Battery 12V2USD 16
Frame—

物料 · Mobile base

零件数量USCN
Servo motor4USD 13.89CNY 110
Omni wheel3USD 47CNY 135
USB camera3CNY 125
(optional) Bearing3CNY 6
Bearing8CNY 3
M2×12 Phillips screw12
M3×12 hex socket screw36
M3×18 hex socket screw12
M3×30 hex socket screw8
M3 hex nut8
M3x5x4 heat-set insert36CNY 5
M4×12 hex socket screw20
M4x6x5 heat-set insert12CNY 4
Adhesive1CNY 12
Servo extension cable2CNY 3
Battery2USD 43CNY 130
USB Type-C cable1USD 10CNY 20
Waveshare Bus Servo Controller1USD 13CNY 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 升起或降低升降机构,无需在机器人上安装单板计算机。

常见问题

  • 连接器 STL 网格导出错误,无法正确准备打印模型 #1
  • 树莓派连接双摄像头时无法打开视频设备 #10
  • 虚拟机遥操作无法绘制 R32Float 纹理 #8
  • STS3215 默认位置模式可能无法执行速度命令 #6

物料

  • 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 微调与部署

文档