- 类别
- 框架与工具 · 训练框架
- 开放程度
- 开源
- 发布时间
- 2025 年 6 月
- 开源协议
- Apache-2.0
- 发布方所在地
- 中国
项目简介
宇树科技官方的强化学习运动控制训练仓库,含两个版本:unitree_rl_lab 基于 Isaac Lab,支持 Go2、H1 和 G1;unitree_rl_mjlab 基于 mjlab(MuJoCo 后端),支持 Go2、A2、G1、R1、H1_2、H2 等。两者都提供速度跟踪行走训练,mjlab 版还有 G1 动作模仿训练。流程覆盖训练、回放、在 unitree_mujoco 中 Sim2Sim 验证和基于 unitree_sdk2 的真机部署。早期 Isaac Gym 版本见 unitree_rl_gym。
Unitree RL Lab 安装要点
来源:README.md依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装 Isaac Lab
按 Isaac Lab 官方安装指南操作,README 标注版本 2.3.0
克隆仓库
放在 IsaacLab 目录之外
git clone https://github.com/unitreerobotics/unitree_rl_lab.git安装扩展
装完重启 shell 让环境生效
conda activate env_isaaclab ./unitree_rl_lab.sh -i下载机器人模型
官方推荐改用 URDF,要 Isaac Sim 5.0 及以上
git clone https://huggingface.co/datasets/unitreerobotics/unitree_model配置模型路径
写进 assets/robots/unitree.py,路径换成自己的
UNITREE_MODEL_DIR = "</home/user/projects/unitree_usd>"验证并开始训练
./unitree_rl_lab.sh -l ./unitree_rl_lab.sh -t --task Unitree-G1-29dof-Velocity
环境要求
来源:README.md- Isaac Sim
- 5.1.0
- Isaac Lab
- 2.3.0
- 旧版 Isaac Sim 4.5来源:Issue #88
- 用 lab21 分支
- URDF 模型方式
- 需要 Isaac Sim 5.0 及以上
- 部署依赖
- yaml-cpp、Boost、Eigen3、spdlog、fmt 和 unitree_sdk2
- Sim2Sim 仿真器
- unitree_mujoco
适配矩阵
来源:README.md机器人在训练和部署各阶段的支持情况,空格表示官方未明确说明
| 名称 | Isaac Lab 训练 | deploy 控制器 | MuJoCo Sim2Sim | 真机部署 |
|---|---|---|---|---|
| G1 29dofREADME 的 Sim2Sim 和 Sim2Real 步骤以它为例 | ✓ | g1_29dof | ✓ | ✓ |
| G1 23dof维护者在 #27 说训练代码还需要时间,有用户反馈自行跑通了真机来源:Issue #27 | — | g1_23dof | — | — |
| Go2 | ✓ | go2 | — | — |
| H1 | ✓ | h1 | — | — |
| Go2Wdeploy/robots 下有控制器目录,README 未列入支持机型来源:robots | — | go2w | — | — |
| H1-2deploy/robots 下有控制器目录,README 未列入支持机型来源:robots | — | h1_2 | — | — |
| B2deploy/robots 下有控制器目录,README 未列入支持机型来源:robots | — | b2 | — | — |
✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
fatal error: nlohmann/json.hpp: No such file or directory原因deploy/include 下的 motion_command.h 用到了这个头文件
解决安装 nlohmann-json3-dev 后重新编译部署程序
来源:Issue #85sudo apt install nlohmann-json3-devWaiting for connection rt/lowstate原因unitree_mujoco 和控制程序的网卡或 domain_id 不一致,DDS 连不上
解决两边显式指定同一网卡和同一 domain_id;同机用 lo 不通时换成实际网卡
来源:Issue #28./g1_ctrl -n eth0No contact sensors added to the prim: '/World/envs/env_0/Robot'.原因USD 文件损坏或没下载完整,模型放在 git lfs 里
解决在 unitree_model 目录执行 git lfs pull 取回 USD,或改用 URDF 方式
来源:Issue #4git lfs pullKeyError: 'class_name'解决核对 Isaac Lab 版本,对齐到项目要求的版本(README 标注 2.3.0)
来源:Issue #115ModuleNotFoundError: No module named 'isaaclab.utils.pretrained_checkpoint'原因pretrained_checkpoint 模块移到了 isaaclab_rl.utils
解决把 scripts/rsl_rl/play.py 里的导入改成从 isaaclab_rl.utils.pretrained_checkpoint 导入
来源:Issue #104[critical] The other process is using the lowcmd channel, please close it first.原因机器人自带的运动控制程序还在运行
解决控制前先关掉自带运动控制;程序检测到后已替你关闭,第二次启动就不再报错
来源:Issue #71
适配机器人
- Unitree Go2
- Unitree A2
- Unitree AS2
- Unitree G1
- Unitree H1
- Unitree H1_2
- Unitree H2
- Unitree R1
