# ROBOTIS OMX 开发百科：5 自由度桌面机械臂与 ROS 2/IL/RL 工作流

> 原文链接：https://robotics.hellobike.com/wiki/robotis-omx-dev-guide
> 频道：wiki | 更新日期：2026-10-22 | 标签：ROBOTIS, OMX, ROS 2, 机械臂, IL/RL, 仿真
> 核心摘要：ROBOTIS OMX 是 5 自由度桌面级 Physical AI 机械臂，面向数据集采集与比较，兼容 ROS 2 工作流，并可结合 open_manipulator 与 cyclo_lab 开展仿真、IL/RL 实验。

# ROBOTIS OMX 开发百科：5 自由度桌面机械臂与 ROS 2/IL/RL 工作流

## 本体与算力接口

ROBOTIS OMX 属于入门级 Physical AI 桌面机械臂，机型类别为 `arm`，自由度为 5。材料中给出的主要定位是数据集采集与比较，也可用于机器人开发、算法验证、教学实训和实验测试。其工作流侧重 ROS 2，并支持 IL/RL 管线，适合从仿真、数据记录到策略训练的开发闭环。

## 官方 SDK 与通信协议

- [cyclo_lab](/sdks/robotis-git-cyclo-lab)：Python 框架，用于基于 Isaac Lab 的 ROBOTIS 机器人 RL/IL 仿真实验；仓库 `https://github.com/ROBOTIS-GIT/cyclo_lab`。README 写明依赖 IsaacLab v2.2.0 或更高，Docker 镜像包含 Isaac Sim 5.1.0、Isaac Lab v2.3.0、CycloneDDS 0.10.2、robotis_dds_python 与 LeRobot 0.3.3。
- [emanual](/sdks/robotis-git-emanual)：JavaScript 开发工具，对应 ROBOTIS e-Manual 页面；仓库 `https://github.com/ROBOTIS-GIT/emanual`。材料给出 Node.js 18.x+ 环境，并通过 `npm install`、`npm run build`、`npm run dev` 构建与预览。
- [open_manipulator](/sdks/robotis-git-open-manipulator)：Python ROS 2 框架，提供 OpenMANIPULATOR 平台控制、传感器集成与 Physical AI 开发接口；仓库 `https://github.com/ROBOTIS-GIT/open_manipulator`，适配 ROS 2 Humble，可按 ROS 2 包规则编译。
- [OpenCR-Hardware](/sdks/robotis-git-opencr-hardware)：开源硬件资料，提供 OpenCR 的 BOM、电路原理图与 PCB Gerber；仓库 `https://github.com/ROBOTIS-GIT/OpenCR-Hardware`，README 提到硬件工具 OrCAD Capture 16.6。
- [OpenCR](/sdks/robotis-git-opencr)：C SDK，用于 ROS 嵌入式控制板 OpenCR；仓库 `https://github.com/ROBOTIS-GIT/OpenCR`，目录包含 Arduino 库、OpenCR package core、固件写入工具、bootloader 与 loader 相关源码。
- [ROBOTIS-OP3](/sdks/robotis-git-robotis-op3)：C++ ROS 包框架，面向 ROBOTIS OP3；仓库 `https://github.com/ROBOTIS-GIT/ROBOTIS-OP3`，材料给出 ROS 1 Kinetic/Noetic 与 catkin 工作空间构建方式。
- [ros2arduino](/sdks/robotis-git-ros2arduino)：C 算法库，帮助 Arduino 板通过 XRCE-DDS 与 ROS 2 通信；仓库 `https://github.com/ROBOTIS-GIT/ros2arduino`。README 的依赖表列出 ros2arduino 0.2.1、ROS2 Dashing Diademata Patch6 与 Micro-XRCE-DDS Agent 1.3.0。

## ROS 2 与仿真资产

OMX 的仿真资产入口指向 ROBOTIS 官方开源仓库 `https://github.com/ROBOTIS-GIT/open_manipulator`，材料说明其为 ROS 2 / Gazebo / MuJoCo 仿真模型仓库，并列出 Gazebo、MuJoCo、ROS 2、Isaac Sim 支持。README 中，[open_manipulator](/sdks/robotis-git-open-manipulator) 也说明该仓库包含 OpenMANIPULATOR 平台的官方 ROS 2 packages，并提供控制机器人、集成传感器和开发 Physical AI 应用所需接口与工具。

## 推荐上手顺序

1. 先阅读 [emanual](/sdks/robotis-git-emanual) 中 OpenMANIPULATOR-X 相关文档，确认 ROS 2 工作流与平台资料入口。
2. 在 Ubuntu 22.04 LTS + ROS 2 Humble / Python 3.10+ 环境下拉取并编译 [open_manipulator](/sdks/robotis-git-open-manipulator)，优先跑通控制、运动学与轨迹规划相关能力。
3. 进入 Gazebo、MuJoCo、ROS 2 或 Isaac Sim 仿真链路，复用官方 open_manipulator 仓库的模型资产。
4. 需要 IL/RL 时，再使用 [cyclo_lab](/sdks/robotis-git-cyclo-lab) 的 Docker 流程与示例任务开展训练、记录、标注和回放。
5. 涉及嵌入式或板级通信时，再结合 [OpenCR](/sdks/robotis-git-opencr)、[OpenCR-Hardware](/sdks/robotis-git-opencr-hardware) 与 [ros2arduino](/sdks/robotis-git-ros2arduino)。

## 来源

- [ROBOTIS：ROBOTIS 产品页](https://www.robotis.com/en/product/ecosystem-hx5-d20.php)
- [GitHub cyclo_lab](https://github.com/ROBOTIS-GIT/cyclo_lab)
- [GitHub emanual](https://github.com/ROBOTIS-GIT/emanual)
- [GitHub open_manipulator](https://github.com/ROBOTIS-GIT/open_manipulator)
- [GitHub OpenCR-Hardware](https://github.com/ROBOTIS-GIT/OpenCR-Hardware)
- [GitHub OpenCR](https://github.com/ROBOTIS-GIT/OpenCR)
- [GitHub ROBOTIS-OP3](https://github.com/ROBOTIS-GIT/ROBOTIS-OP3)
- [GitHub ros2arduino](https://github.com/ROBOTIS-GIT/ros2arduino)

本页由站内机型卡、官方 SDK README 与已验证记录整理而成；命令与版本以仓库当前 README 为准。

## 原始参考来源 (Sources)

- [ROBOTIS：ROBOTIS 产品页](https://www.robotis.com/en/product/ecosystem-hx5-d20.php)
- [GitHub cyclo_lab](https://github.com/ROBOTIS-GIT/cyclo_lab)
- [GitHub emanual](https://github.com/ROBOTIS-GIT/emanual)
- [GitHub open_manipulator](https://github.com/ROBOTIS-GIT/open_manipulator)
- [GitHub OpenCR-Hardware](https://github.com/ROBOTIS-GIT/OpenCR-Hardware)
- [GitHub OpenCR](https://github.com/ROBOTIS-GIT/OpenCR)
- [GitHub ROBOTIS-OP3](https://github.com/ROBOTIS-GIT/ROBOTIS-OP3)
- [GitHub ros2arduino](https://github.com/ROBOTIS-GIT/ros2arduino)