正在连接信源…

Koch v1.1 低成本机械臂(主从臂一对) 复刻全流程

Koch v1.1 低成本机械臂(主从臂一对) 从采购、打印、组装到装软件、标定和训练的 126 个步骤,附物料表、购买链接与官方出处。

创作者在 README 中的物料估算:主臂 199 美元、从臂 278 美元(美国价,一对约 477 美元);欧洲 305 + 368 欧元、英国 222 + 285 英镑、中国 1,696 + 2,251 元、日本 6,993 + 15,446 日元。不含 3D 打印耗材、打印机与运费,README 称价格因地区略有差异;无官方套件售价

物料 · Leader Arm

零件数量USCNJPEU
Dynamixel XL330-M077-T6USD 24CNY 255JPY 4070
XL330 Frame and Idler Wheel 4pcs set1USD 10CNY 100JPY 2024
Waveshare Serial Bus Servo Driver Board1USD 10CNY 24
5V Power Supply1USD 6CNY 10JPY 899GBP 10
Jumper Wires 3*40 pcs set (M-M, M-F, F-F)1USD 7CNY 10GBP 5
Table Clamp1USD 6CNY 8
Table Clamp 4pcs set1
1.5mm Star/Cruciform Screwdriver 2pcs set1GBP 4CNY 2
USB C-A or C-C 2pcs set1GBP 6CNY 12

物料 · Follower Arm

零件数量USCNJPEU
Dynamixel XL430-W250-T2USD 50CNY 485JPY 6831
Dynamixel XL330-M288-T4USD 24CNY 255JPY 4070
XL330 Frame and Idler Wheel 4pcs set1USD 10CNY 100JPY 2024
XL430 Idler Wheel set1USD 7CNY 75JPY 836
Waveshare Serial Bus Servo Driver Board1USD 10CNY 24
Voltage Reducer1GBP 15CNY 11
12V Power Supply1USD 12CNY 20JPY 1685GBP 13
Jumper Wires 3*40 pcs set (M-M, M-F, F-F)1USD 7CNY 10GBP 5
Table Clamp1USD 6CNY 8
Table Clamp 4pcs set1
1.5mm Star/Cruciform Screwdriver 2pcs set1GBP 4CNY 2
USB C-A or C-C 2pcs set1GBP 6CNY 12

采购

  • 采购主臂和从臂

    使用文档提供的区域链接,为主臂和从臂订购现货零件。可用的区域包括美国、欧盟、英国、中国和日本。

  • 订购主臂零件

    使用文档中列出的区域链接,订购主臂所需的现货零件。

  • 订购从臂舵机

    为从臂订购2个 Dynamixel XL430-W250-T,并使用文档提供的美国、欧盟、英国、中国和日本购买链接。

  • 选择3D打印机

    建议使用0.2 mm最小层高、0.4 mm或更小喷嘴直径、约30%填充率,并使用PLA+、ABS、PETG等强度足够的塑料。示例打印机包括Prusa Mini+、Bambu P1和Ender3。

  • 准备打印耗材和工具

    准备标准固体胶棒和刮刀。

  • 准备打印床辅助工具

    准备胶棒和刮刀;胶棒用于防止零件粘在打印床上,刮刀用于从打印床上刮下零件。可根据具体打印机的说明确认是否需要。

打印与加工

  • 校准打印机并调平热床

    按照打印机专用说明校准打印机,并正确设置热床水平。

  • 清洁打印热床

    清除热床上的灰尘和油脂;如果使用水或其他液体清洁热床,之后将热床擦干。

  • 在热床涂胶

    用标准固体胶棒在热床打印区域涂上薄而均匀的一层胶,避免结块或涂抹不均。

  • 装入打印耗材

    按照打印机专用说明装入打印耗材。

  • 匹配打印机设置

    将打印机设置调整为最接近建议值;打印机有多个选项时,选择最接近建议设置的选项。

  • 选择并打印硬件文件

    检查文件类型,从hardware文件夹选择文件并开始打印。

  • 打印Leader_Base

    从`hardware/leader/STL`打印一个`Leader_Base`。

  • 打印Leader_Elbow_To_Wrist

    从`hardware/leader/STL`打印一个`Leader_Elbow_To_Wrist`。

  • 打印Leader_Elbow_To_Wrist_Extension

    从`hardware/leader/STL`打印一个`Leader_Elbow_To_Wrist_Extension`。

  • 打印Leader_Gripper_Handle

    从`hardware/leader/STL`打印一个`Leader_Gripper_Handle`。

  • 打印Leader_Gripper_Trigger

    从`hardware/leader/STL`打印一个`Leader_Gripper_Trigger`。

  • 打印Leader_Shoulder_To_Elbow

    从`hardware/leader/STL`打印一个`Leader_Shoulder_To_Elbow`。

  • 打印Leader_Platform

    从`hardware/leader/STL`打印一个`Leader_Platform`。

  • 打印Robotis_FPX330_S101

    从`hardware/leader/STL`打印一个`Robotis_FPX330_S101`。

  • 打印Follower_Base

    从`hardware/follower/STL`打印一个`Follower_Base`。

  • 打印Follower_Elbow_To_Wrist

    从`hardware/follower/STL`打印一个`Follower_Elbow_To_Wrist`。

  • 打印Follower_Elbow_To_Wrist_Extension

    从`hardware/follower/STL`打印一个`Follower_Elbow_To_Wrist_Extension`。

  • 打印Follower_Gripper_Moving_Part

    从`hardware/follower/STL`打印一个`Follower_Gripper_Moving_Part`。

  • 打印Follower_Gripper_Static_Part

    从`hardware/follower/STL`打印一个`Follower_Gripper_Static_Part`。

  • 打印Follower_Shoulder_Rotation

    从`hardware/follower/STL`打印一个`Follower_Shoulder_Rotation`。

  • 打印Follower_Shoulder_To_Elbow

    从`hardware/follower/STL`打印一个`Follower_Shoulder_To_Elbow`。

  • 打印可选HuggingFace_Block

    打印一个可选的`HuggingFace_Block`。

  • 打印可选LeRobot_Block

    打印一个可选的`LeRobot_Block`。

  • 从热床取下打印件

    打印完成后,使用刮刀将零件从热床刮下。

  • 清除零件支撑材料

    从打印零件上清除所有支撑材料。

  • 下次打印前重新涂胶

    开始下一次打印前,重新在热床上涂抹固体胶棒。

  • 转换打印文件格式

    建议的打印机均可打印STL文件。如果打印机只支持其他格式,请在打印前将文件转换为正确的扩展名。

  • 打印可选的跟随臂部件

    该部件不是必须打印的,但能让跟随臂接触地面;当前设置下,跟随臂本身无法触地。

组装

  • 组装主臂和从臂

    按照组装视频组装主臂和从臂。

  • 用USB-C连接电脑

    使用USB-C数据线将每个臂连接到电脑。

  • 安装主臂平台螺母

    将四颗M2螺母插入主臂平台底部的凹槽中。

  • 固定主臂平台

    使用四颗M2x5机用螺钉将Leader_Platform固定到Leader_Base上。

  • 移开舵机驱动板

    Temporarily remove the Waveshare Serial Bus Servo Driver Board to access the two fasteners beneath it.

  • 给主臂舵机供电

    虽然串行总线舵机驱动板的直流输入建议为9至12.6V,但主臂只使用5V。较低电压不会损坏驱动板,并且是正确给主臂舵机供电所必需的。

软件与固件

  • 使用 conda 安装 Miniforge

    下载适用于当前操作系统和架构的 Miniforge3 安装程序并运行。

  • 选择环境管理器

    指南推荐使用带有 miniforge 的 conda。如果使用 uv 或 venv 等其他环境管理器,请确保已安装 Python >=3.12。

  • 创建 conda 环境

    创建一个名为 lerobot 并使用 Python 3.12 的 conda 环境。

  • 创建 uv 环境

    作为 uv 的替代方案,安装 Python 3.12 并使用它创建虚拟环境。

  • 激活 conda 环境

    每次打开 shell 以使用 LeRobot 时,都要激活 lerobot conda 环境。

  • 在 WSL 的 conda 中安装 evdev

    在 WSL 中使用 conda 安装 LeRobot 时,还需从 conda-forge 安装 evdev。

  • 激活 uv 虚拟环境

    每次打开 shell 以使用 LeRobot 时,都要激活虚拟环境。在 Linux 或 macOS 上使用 Linux/macOS 命令,在 Windows 上使用 Windows PowerShell 命令。

  • 在 WSL 的 uv 中安装 evdev

    在 WSL 中使用 uv 安装 LeRobot 时,安装 Linux evdev 开发软件包和 evdev Python 软件包。

  • 检查 Apple Silicon 要求

    Apple Silicon 上的 PyTorch 需要 macOS 14 或更高版本。MPS 加速需要 macOS 15 或更高版本;在 macOS 14 上,LeRobot 回退到 CPU。

  • 检查 Linux 驱动要求

    Linux 上的默认 PyTorch wheel 需要 580.65 或更高版本的 NVIDIA 驱动。对于较旧的驱动,请使用 PyTorch CUDA 变体。

  • 在不支持的平台上跳过 ffmpeg

    在 macOS Intel (x86_64) 或 Linux armv7l 上跳过 ffmpeg 安装并进入步骤 3,因为 LeRobot 会自动回退到 pyav。

  • 使用 conda 安装 ffmpeg

    在支持 TorchCodec 的平台上,于 conda 环境中安装 ffmpeg。这通常会安装带 libsvtav1 编码器的 ffmpeg 8.X。

  • 安装指定版本的 ffmpeg

    如果缺少 libsvtav1 或 ffmpeg 与 torchcodec 存在版本不匹配,请明确安装 ffmpeg 7.1.1。

  • 使用系统级 ffmpeg

    使用 PyTorch >= 2.10 和 TorchCodec ≥ 0.10 时,TorchCodec 可以动态链接系统级 ffmpeg 安装。这适合使用 uv 或其他非 conda 环境管理器。

  • 在 Ubuntu 或 Debian 上安装 FFmpeg

    使用 apt 安装 FFmpeg,为机器人录制和视频工作流提供所需的系统依赖。

  • 在 Apple Silicon 上安装 FFmpeg

    在采用 Apple Silicon 的 macOS 系统上使用 Homebrew 安装 FFmpeg。

  • 为旧版 PyTorch 使用 Conda 安装 FFmpeg

    系统级 FFmpeg 支持 PyTorch >= 2.10 和 TorchCodec >= 0.10。对于较旧的 PyTorch 版本,请改用 Conda 安装 FFmpeg。

  • 安装 LeRobot 基础软件包

    从 PyPI 安装基础 lerobot 软件包。该安装仅包含核心机器学习依赖;大多数工作流还需要添加额外组件。

  • 安装功能额外组件

    添加与所需工作流对应的功能额外组件。使用 uv 时,将 pip install 替换为 uv pip install。

  • 安装组合工作流额外组件

    安装用于录制、回放、校准、训练或完整功能的组合额外组件。必要时可以组合多个额外组件。

  • 安装策略、环境和硬件额外组件

    安装策略、仿真环境或硬件支持所需的具体额外组件。可以组合多个额外组件。

  • 在 Linux 上安装 LeRobot

    在 Linux 上,torch 和 torchvision 的 PyPI 默认轮子是 CUDA 13 构建,需要 580.65 或更高版本的驱动。macOS 和 Windows 使用 PyPI 默认轮子,可以跳过本节。

  • 安装匹配的 CUDA PyTorch

    对于较旧的驱动或 GPU,先从匹配的 PyTorch 索引安装 PyTorch,然后安装 LeRobot。cu126 索引适用于支持 CUDA 12 的驱动;由于 torch 2.15 没有 CUDA 12 构建,该索引会安装 torch 2.14。从 CPU 索引安装 torchcodec;当 torch 低于 2.11 时,从兼容性表中选择匹配的 TorchCodec 版本。

  • 使用 uv pip 安装 LeRobot

    使用 uv pip 时,可以通过 --torch-backend 一步选择 CUDA 索引。cu126 后端会为支持 CUDA 12 的较旧驱动安装 CUDA 12 的 PyTorch 构建。

  • 配置 uv lock 的 CUDA 来源

    uv sync 总是安装已提交的锁定文件。要更改 uv sync 使用的 CUDA 构建,请在 pyproject.toml 的 [tool.uv.index] 和 [tool.uv.sources] 中添加索引,然后重新运行 uv lock。

  • 安装 Linux 构建依赖

    如果遇到构建错误,请在 Linux 上安装 cmake、build-essential、python3-dev、pkg-config 以及列出的 FFmpeg 开发库。其他系统请参阅 PyAV 编译安装指南。

  • 添加手腕和顶部摄像头

    按照摄像头指南向设置中添加摄像头。遥操作示例使用名为 wrist 和 top 的两个摄像头。

  • 配置LeRobot

    建议使用LeRobot来编程和控制该机器人。

标定与测试

  • 连接跟随臂控制器

    使用 USB 将电脑连接到跟随臂控制器板,并为控制器板连接 12V 电源。引导臂使用 5V 电源。

  • 准备电机配置

    使用上一步找到的端口运行电机设置命令,并通过 id 参数为跟随臂指定名称。API 示例提供了等效配置。

  • 仅连接夹爪电机

    控制器板只连接夹爪电机,其他电机均保持断开。夹爪电机不得与其他电机菊花链连接,然后按 Enter,脚本会自动设置其 ID 和波特率。

  • 检查电机连接

    如果出现错误,请检查电源、电脑与控制器板之间的 USB 线,以及控制器板到电机的 3 针线缆。使用 Waveshare 控制器板时,应将两个跳线帽都置于 B 通道(USB)。

  • 确认夹爪电机 ID

    确认设置程序显示夹爪电机 ID 已设置为 6。

  • 仅连接腕部电机

    完成夹爪电机设置后,控制器板只连接 wrist_roll 电机,然后按 Enter。

采数据与训练

  • 使用 CLI 通过 Rerun 遥操作

    使用 SO101 follower 和 leader 运行遥操作命令。将 wrist 摄像头配置为 OpenCV 索引 0,将 top 摄像头配置为索引 1,两者分辨率均为 640×480、帧率均为 30 fps,并启用数据显示。

  • 运行 Python 遥操作循环

    创建带有 wrist 和 top 摄像头的 SO101 follower 与 leader 配置,初始化 Rerun 可视化并连接两个设备。以 30 Hz 读取机器人观测值和 leader 动作,将动作发送给机器人,并记录观测值和动作用于可视化;可视化后端也可以改为 Foxglove。

  • 在录制分集之间重置环境

    当录制未停止且仍有后续分集或正在重录当前分集时,重置环境。

  • 重录并清除分集缓冲区

    重录时,重置重录和提前退出标志,清除分集缓冲区,然后继续录制。

  • 保存每个已完成的分集

    将已完成分集保存到数据集中,并增加分集索引。

  • 完成录制数据集

    保存所有分集后完成数据集。

  • 断开设备并推送数据集

    停止录制,断开机器人和遥操作设备,并将完成的数据集推送到 Hub。

  • 保持相机数据集键一致

    使用 wrist 和 top 相机名称作为 observation.images.wrist 和 observation.images.top。部署策略时需要相同的相机名称和分辨率,因此在整个教程中重复使用相同的 --robot.cameras 值。

  • 选择带时间戳或固定的数据集仓库名称

    lerobot-record 会将会话日期和时间附加到 --dataset.repo_id。添加 --dataset.no_stamp=true 可保留传入的准确仓库名称。

  • 查找带时间戳的数据集名称

    在 Hugging Face 个人资料页或使用 ls ~/.cache/huggingface/lerobot/${HF_USER} 查找完整仓库名称。在出现 record-test_YYYYMMDD_HHMMSS 的位置使用该名称。

  • 打印已上传数据集的 URL

    录制结束时,数据集会上传到 Hugging Face 页面。使用带时间戳的数据集名称打印其 URL。

  • 添加并发现数据集标签

    数据集会自动带有 LeRobot 标签。可添加 --dataset.tags='["tutorial"]' 等自定义标签,也可通过搜索 LeRobot 标签查找其他 LeRobot 数据集。

  • 手动将数据集推送到 Hub

    手动将本地数据集推送到 Hugging Face Hub。

  • 上传录制的数据集

    将本地 LeRobot 缓存中的带时间戳数据集作为 dataset 上传到 Hugging Face Hub。

  • 将录制数据存储在磁盘上

    录制数据使用 LeRobotDataset 格式,并在录制过程中存储在磁盘上。

  • 禁用数据集自动上传

    设置 --dataset.push_to_hub=False 以禁用上传。

  • 保留自动录制检查点

    录制会话运行时会自动创建检查点。

  • 恢复中断的录制

    出现问题后,或要向同一数据集添加片段时,使用 --resume=true 重新运行相同的录制命令。

  • 指定完整数据集名称

    使用 --dataset.repo_id=${HF_USER}/record-test_YYYYMMDD_HHMMSS 传入包含时间戳的完整数据集名称。

  • 设置新增片段数量

    恢复录制时,--dataset.num_episodes 应设为要额外录制的片段数,而不是数据集的目标总数。

  • 设置本地恢复路径

    将 --dataset.root="local_path" 设为保存新增数据集部分的本地路径;恢复录制时必须设置此项。

  • 开始新数据集

    不使用 --resume=true 重新运行命令会创建一个带新时间戳的数据集。

  • 删除已有的无时间戳数据集

    使用 --dataset.no_stamp=true 前,先删除已有的数据集目录。

  • 设置片段录制时长

    设置 --dataset.episode_time_s=60,使每个录制片段持续 60 秒。

  • 设置环境重置时长

    设置 --dataset.reset_time_s=60,为每个片段结束后的环境重置提供 60 秒。

  • 设置片段总数

    设置 --dataset.num_episodes=50,以总共录制 50 个片段。

  • 进入下一个片段

    按右方向键或 n,提前停止当前片段或重置阶段,并进入下一个片段。

  • 重新录制当前片段

    按左方向键或 r,取消当前片段并重新录制。

  • 停止并完成录制

    按 Escape 或 q,立即停止会话、编码视频并上传数据集。

  • 在支持的会话中使用快捷键

    录制快捷键支持 X11、Wayland 以及无界面或 SSH 会话。没有全局键盘后端时,lerobot-record 会从保持焦点的交互式终端读取相同按键。

  • 选择数据集任务

    创建一个更大的训练数据集,任务是在不同位置抓取物体并将其放入箱子。

  • 录制足够的回合

    至少录制 50 个回合,每个物体位置录制 10 个回合。

  • 保持录制一致

    固定相机,保持一致的抓取行为,并确保被操作的物体在相机画面中可见。

  • 逐步增加变化

    实现可靠的抓取表现后,再增加抓取位置、抓取方式或改变相机位置。避免过快加入过多变化,因为这可能妨碍结果。

  • 检查录制节奏

    训练前阅读节奏报告,并将实际节奏与目标进行比较。注意时间戳由帧索引生成,因此以 25 Hz 运行的会话仍可能生成声称频率为 30 的数据集。

  • 恢复 Hub 训练任务

    使用 --resume=true 在 a10g-small 作业上恢复 ${HF_USER}/my_policy 训练任务。

  • 恢复本地训练任务

    从 outputs/train/act_so101_test/checkpoints/last/pretrained_model/train_config.json 恢复训练。检查点会先上传到私有 Hub 仓库。

  • 配置作业和检查点设置

    作业设置来自当前命令,可按需覆盖 --job.target、--job.timeout 等设置。保持 --save_checkpoint_to_hub=true,以便恢复后的任务以后还能再次恢复。

  • 上传最新策略检查点

    训练完成后,将 outputs/train/act_so101_test/checkpoints/last/pretrained_model 上传到 ${HF_USER}/act_so101_test。

  • 上传中间策略检查点

    将 CKPT 设置为检查点步数,例如 010000,然后上传该检查点的 pretrained_model 目录。

用起来

  • 使用字母快捷键

    使用 n 代替右方向键进入下一片段,使用 r 代替左方向键重新录制,使用 q 代替 Escape 退出。

  • 准备起始操作物积木

    准备两个与2×4乐高积木尺寸相同的方块。它们不必打印,但可作为初始操作物。

常见问题

  • SolidWorks 版本不兼容,无法打开 CAD 文件 #6
  • 缺少地区性零件供应商和采购链接 #7 #9 #17 #22
  • 伺服型号推荐相互冲突,零件选型困难 #11
  • 主臂底座 CAD 和 STL 与装配视频不一致 #14 #24
  • 伺服连接器端口用途不清,容易错误接线 #18
  • 难以找到伺服驱动板固件代码和 IDE #25
  • 无法通过 Waveshare 伺服驱动板升级 XL-430 固件 #13
  • 电机链设置后,部分或全部电机未被识别 #23 #28

物料

  • 从臂:Dynamixel XL430-W250-T ×2(肩部转动与抬升,每个约 50 美元)+ XL330-M288-T ×4(肘、腕俯仰、腕转动、夹爪,每个约 24 美元)
  • 主臂:Dynamixel XL330-M077-T ×6(每个约 24 美元),带手柄与扳机式夹爪把手
  • 每臂一块 Waveshare 串口舵机驱动板;从臂 12V 电源加降压模块,主臂 5V 电源
  • XL330 支架与惰轮 4 件套(用 3 个)、XL430 惰轮套件、杜邦线、USB‑C 线、桌面夹具
  • 3D 打印件:主臂 7 件(含主臂平台)与 FPX330-S101 支架,从臂 7 件;可选 Hugging Face 与 LeRobot 积木块作抓取物

工具

  • 3D 打印机:层高 0.2 mm 以内、喷嘴不大于 0.4 mm、约 30% 填充,PLA+、ABS 或 PETG;胶棒与铲刀
  • 1.5 mm 十字螺丝刀;无需烙铁

技能

  • 跟装配视频组装两臂(README 注明主臂平台已改为螺丝固定,与视频不同)
  • LeRobot:lerobot-find-port 找端口、lerobot-setup-motors 设舵机 ID 与波特率、lerobot-calibrate 校准
  • Python 基础;遥操作、录制数据集与训练策略

软件

  • LeRobot(Apache‑2.0):pip install -e ".[dynamixel]",机器人类型 koch_follower,遥操作类型 koch_leader
  • Dynamixel SDK(原版 README:pip install dynamixel-sdk)

文档