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
| 零件 | 数量 | US | CN | JP | EU |
|---|---|---|---|---|---|
| Dynamixel XL330-M077-T | 6 | USD 24 | CNY 255 | JPY 4070 | |
| XL330 Frame and Idler Wheel 4pcs set | 1 | USD 10 | CNY 100 | JPY 2024 | |
| Waveshare Serial Bus Servo Driver Board | 1 | USD 10 | CNY 24 | ||
| 5V Power Supply | 1 | USD 6 | CNY 10 | JPY 899 | GBP 10 |
| Jumper Wires 3*40 pcs set (M-M, M-F, F-F) | 1 | USD 7 | CNY 10 | GBP 5 | |
| Table Clamp | 1 | USD 6 | CNY 8 | ||
| Table Clamp 4pcs set | 1 | ||||
| 1.5mm Star/Cruciform Screwdriver 2pcs set | 1 | GBP 4 | CNY 2 | ||
| USB C-A or C-C 2pcs set | 1 | GBP 6 | CNY 12 |
物料 · Follower Arm
| 零件 | 数量 | US | CN | JP | EU |
|---|---|---|---|---|---|
| Dynamixel XL430-W250-T | 2 | USD 50 | CNY 485 | JPY 6831 | |
| Dynamixel XL330-M288-T | 4 | USD 24 | CNY 255 | JPY 4070 | |
| XL330 Frame and Idler Wheel 4pcs set | 1 | USD 10 | CNY 100 | JPY 2024 | |
| XL430 Idler Wheel set | 1 | USD 7 | CNY 75 | JPY 836 | |
| Waveshare Serial Bus Servo Driver Board | 1 | USD 10 | CNY 24 | ||
| Voltage Reducer | 1 | GBP 15 | CNY 11 | ||
| 12V Power Supply | 1 | USD 12 | CNY 20 | JPY 1685 | GBP 13 |
| Jumper Wires 3*40 pcs set (M-M, M-F, F-F) | 1 | USD 7 | CNY 10 | GBP 5 | |
| Table Clamp | 1 | USD 6 | CNY 8 | ||
| Table Clamp 4pcs set | 1 | ||||
| 1.5mm Star/Cruciform Screwdriver 2pcs set | 1 | GBP 4 | CNY 2 | ||
| USB C-A or C-C 2pcs set | 1 | GBP 6 | CNY 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乐高积木尺寸相同的方块。它们不必打印,但可作为初始操作物。
常见问题
物料
- 从臂: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)