训练框架开源

Unitree RL Lab

宇树科技中国

GitHub 仓库 unitreerobotics/unitree_rl_lab

又称 unitree_rl_lab、Unitree RL Mjlab、unitree_rl_mjlab

类别
框架与工具 · 训练框架
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 安装 Isaac Lab

    按 Isaac Lab 官方安装指南操作,README 标注版本 2.3.0

  2. 克隆仓库

    放在 IsaacLab 目录之外

    git clone https://github.com/unitreerobotics/unitree_rl_lab.git
  3. 安装扩展

    装完重启 shell 让环境生效

    conda activate env_isaaclab
    ./unitree_rl_lab.sh -i
  4. 下载机器人模型

    官方推荐改用 URDF,要 Isaac Sim 5.0 及以上

    git clone https://huggingface.co/datasets/unitreerobotics/unitree_model
  5. 配置模型路径

    写进 assets/robots/unitree.py,路径换成自己的

    UNITREE_MODEL_DIR = "</home/user/projects/unitree_usd>"
  6. 验证并开始训练

    ./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 后重新编译部署程序

sudo apt install nlohmann-json3-dev
来源:Issue #85
Waiting for connection rt/lowstate

原因unitree_mujoco 和控制程序的网卡或 domain_id 不一致,DDS 连不上

解决两边显式指定同一网卡和同一 domain_id;同机用 lo 不通时换成实际网卡

./g1_ctrl -n eth0
来源:Issue #28
No contact sensors added to the prim: '/World/envs/env_0/Robot'.

原因USD 文件损坏或没下载完整,模型放在 git lfs 里

解决在 unitree_model 目录执行 git lfs pull 取回 USD,或改用 URDF 方式

git lfs pull
来源:Issue #4
KeyError: 'class_name'

解决核对 Isaac Lab 版本,对齐到项目要求的版本(README 标注 2.3.0)

来源:Issue #115
ModuleNotFoundError: 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

获取方式

发布方

相关概念

数据来源

本页信息均整理自以下公开资料。

12 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

Unitree RL Lab(unitree_rl_lab):安装步骤、环境要求与常见报错 | 具身集